Document that we now support Integer advanced indexing (not boolean mask)

@jlowin raised the documention issue and the not support for boolean indexing.