DOC: missing docstring substitution for Series/DataFrame.set_axis()

[simonjayhawkins]

https://dev.pandas.io/docs/reference/api/pandas.Series.set_axis.html
https://dev.pandas.io/docs/reference/api/pandas.DataFrame.set_axis.html

[MarcoGorelli]

Should the DataFrame and Series examples in the docstring be separated too?

[simonjayhawkins]

It would make the docs better but I think would need to override the set_axis method in series.py and frame.py to do this. Not sure worth it for the amount of duplication (esp. of typing), though no strong preference.

[giuliobeseghi]

Does it even make sense to have the parameter axis for a Series?

[giuliobeseghi]

Also, it would be if we could do this:

df.set_axis(index=my_ind, columns=my_cols)

instead of

df.set_axis(my_ind).set_axis(my_cols, axis=1)

Like the rename function: https://pandas.pydata.org/pandas-docs/stable/reference/api/pandas.DataFrame.rename.html