DOC: further improvements for boolean array indexing doc