DOC: Add Index.difference to API doc
Add `Index.difference` to api doc rather than deprecated `Index.diff`  (#8226)

And is it OK to remove `Index.diff` alias because #6581 lists #8227 (which closes #8226)?
