Documentation does not reflect deprecation of linear indexing

[j-fu]

The documentation does not reflect the deprecation of linear indexing (which I find a bit sad BTW):

RecursiveArrayTools.jl/src/vector_of_array.jl

Line 14 in 80f2c86

A[i] # Returns the ith array in the vector of arrays

[ChrisRackauckas]

which I find a bit sad BTW

Note that we are doing this in order to bring it back in the future, but under a proper AbstractArray definition, i.e. that it is A[i * nj] = A[i,j] like a matrix. Currently this is not true because A[i] returns the i'th column, which makes it not an AbstractArray, which then breaks a lot of downstream integration. So we plan to bring this back as an AbstractArray (this is the bigger change, removing <: AbstractArray because it's required to ensure AD correctness), but since that would change the meaning of A[i] we need a deprecation period so as to help people update their code before imposing a new meaning to it.

[j-fu]

Ah ok. Sounds reasonable. I already had the idea to make my own getindex for my subtype, so
may be this strategy should be explained a bit in the docs.
My code doesn't depend on it, but a couple of examples, so I will just update them at some point.