DOC: Update pandas.DataFrame.droplevel docstring

[asyarif93]

• closes DOC: Fix errors in pandas.DataFrame.droplevel pandanistas/pandanistas_sprint_jakarta2020#23
• 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.DataFrame.droplevel:

################################################################################
#################### Docstring (pandas.DataFrame.droplevel) ####################
################################################################################

Return DataFrame with requested index / column level(s) removed.

.. versionadded:: 0.24.0

Parameters
----------
level : int, str, or list-like
    If a string is given, must be the name of a level
    If list-like, elements must be names or positional indexes
    of levels.

axis : {0 or 'index', 1 or 'columns'}, default 0
    Axis along which the level(s) is removed:

    * 0 or 'index': remove level(s) in column.
    * 1 or 'columns': remove level(s) in row.

Returns
-------
DataFrame
    DataFrame with requested index / column level(s) removed.

Examples
--------
>>> df = pd.DataFrame([
...     [1, 2, 3, 4],
...     [5, 6, 7, 8],
...     [9, 10, 11, 12]
... ]).set_index([0, 1]).rename_axis(['a', 'b'])

>>> df.columns = pd.MultiIndex.from_tuples([
...     ('c', 'e'), ('d', 'f')
... ], names=['level_1', 'level_2'])

>>> df
level_1   c   d
level_2   e   f
a b
1 2      3   4
5 6      7   8
9 10    11  12

>>> df.droplevel('a')
level_1   c   d
level_2   e   f
b
2        3   4
6        7   8
10      11  12

>>> df.droplevel('level_2', axis=1)
level_1   c   d
a b
1 2      3   4
5 6      7   8
9 10    11  12

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

1 Errors found:
	See Also section not found

[datapythonista]

lgtm, thanks for the fixes.

Can you update your branch with master, so the CI is green (git fetch upstream && git merge upstream/master from your branch, you need to have the upstream remote set to the original pandas repo).

Also, can you remove droplevel from this line: https://github.com/pandas-dev/pandas/blob/master/ci/code_checks.sh#L272 Now that you fixed the examples we don't need to exclude running its tests.

Thank you!

[WillAyd]

@asyarif93 can you merge master and repush again to get CI green?

[WillAyd]

Thanks @asyarif93