I was originally thinking we'd remove this method in 3.0 and than add a deprecation like this to 2.99.  I'm open to keeping it deprecated in 3.0, though, especially if you think it's important.  Generally, for most breaking changes like this I'm in favor of deprecating in 2.99 and removing in 3.0, except in a few circumstances:

* It could trip up newcomers who are using an old tutorial
* The API is likely to be used by an extension gem, which the user may not have direct control over and can't easily update during the 2.x -> 2.99 -> 3.0 migration process.

Do you think either of these apply here?