DOC:https://pandas.pydata.org/pandas-docs/stable/reference/api/pandas.DataFrame.reindex.html#pandas.DataFrame.reindex

[2bon]

Location of the documentation

https://pandas.pydata.org/pandas-docs/stable/reference/api/pandas.DataFrame.reindex.html#pandas.DataFrame.reindex

Documentation problem

Returns
DataFrame with changed index.

Suggested fix for documentation

fix= a NEW DataFrame instance with changed index,NOT changing old instance .
why? I thought old instance has changed index.

[MarcoGorelli]

Thanks @2bon for the report - the docs currently say

A new object is produced unless the new index is equivalent to the current one and copy=False.

but if you think it could be clarified, pull requests are welcome https://pandas.pydata.org/pandas-docs/stable/development/contributing.html

[2bon]

Thx @MarcoGorelli 😊,
Could we make it ez 2 read, pls!
now is 2 ivory-Towered and confusing😥. Big Pain Point!
(unless the new index is equivalent to the current one ) if so, why do I reIndex? let's ignore 1%% corner case

[gauravchandok]

Is someone working on this issue or can I take it?

[MarcoGorelli]

@gauravchandok sure, pull requests are welcome if you think the docs can be clarified

[2bon]

@gauravchandok ya, thx

[2bon]

Hi, any update?

[MarcoGorelli]

Hi, any update?

as mentioned above, pull requests are welcome, see here for how to contribute

[MarcoGorelli]

Closing for now as there doesn't seem to be any traction here, but feel free to open a PR if you think this docstring can be clarified