DOC: Rework the advanced indexing documentation.

Mostly makes the advanced indexing doc much more example based,
and prominently mentions the np.ix_ function.
Some subtleties (some of which are new) are also mentioned.
Merge pull request #4076 from seberg/advanced-indexing-doc

DOC: Rework the advanced indexing documentation.