Doc: API docstrings for indexers (GH6920)
WIP 
Closes #6920 

For now, I just copied the relevant parts of the tutorial docs (in indexing.rst). 
I should also include `__getitem__` for `[]`

:+1: from me
 @jorisvandenbossche thanks!

thanks!
