The official documentation is terrible. It's practically an example of how bad documentation can get. The developer documents are verbose and say little.

This is perhaps one of the most commonly used widgets in Android: https://developer.android.com/reference/android/support/v7/w...

It doesn't say why it's deprecated and what it's replaced with. The link is even more confusing. And the document itself also doesn't say what a RecyclerView is or how to use it.