DOC: Update the pandas.Index.is_ docstring

[garyteofanus]

• closes Fix PR08 error in pandas.Index.is_ pandanistas/pandanistas_sprint_ui2020#6
• tests added / passed
• passes black pandas
• passes git diff upstream/master -u -- "*.py" | flake8 --diff
• whatsnew entry

Output of python scripts/validate_docstrings.py pandas.Index.is_:

################################################################################
################################## Validation ##################################
################################################################################

1 Errors found:
        No examples section found

[WillAyd]

Looks good though failing CI atm

[WillAyd]

Suggested change

	Index.identical : Works like Index.is_ but also check metadata.
	identical : Works like ``Index.is_`` but also check metadata.

Might fix CI

[datapythonista]

I don't really understand the build error.

I think we need to keep the Index in Index.identical.

You can also try:

Suggested change

	Index.identical : Works like Index.is_ but also check metadata.
	Index.identical : Same but also checks metadata.

[jbrockmendel]

@garyteofanus can you see if @WillAyd's suggestion fixes the CI?

[datapythonista]

@garyteofanus can you have a look and see if the documentation builds correctly with any of the suggested options? Would be great to get this merged.

[datapythonista]

Suggested change

	Boolean indicating if both object have same underlying data,
	True if both object have same underlying data, False otherwise.

[datapythonista]

I don't really understand the build error.

I think we need to keep the Index in Index.identical.

You can also try:

Suggested change

	Index.identical : Works like Index.is_ but also check metadata.
	Index.identical : Same but also checks metadata.

[datapythonista]

Closing as stale. @garyteofanus let us know if you finally want to finish this.

[cvanweelden]

I'll submit a new pull request for this today as part of PyData Amsterdam sprint.