Question regarding Series.argsort documentation

[dsaxton]

Series.argsort has three arguments, axis, kind and order, but only kind is actually used. Should the other two be removed from the documentation? (I'm guessing they were once used and are left in the code for compatibility reasons?)

https://pandas.pydata.org/pandas-docs/stable/generated/pandas.Series.argsort.html

[TomAugspurger]

I believe axis and order are needed to match the signature of `np.argsort`, which dispatches to objects with a `.argsort` method,

…

On Thu, Jan 17, 2019 at 7:19 AM Daniel Saxton ***@***.***> wrote: Series.argsort has three arguments, axis, kind and order, but only kind is actually used. Should the other two be removed from the documentation? (I'm guessing they were once used and are left in the code for compatibility reasons?) https://pandas.pydata.org/pandas-docs/stable/generated/pandas.Series.argsort.html — You are receiving this because you are subscribed to this thread. Reply to this email directly, view it on GitHub <#24816>, or mute the thread <https://github.com/notifications/unsubscribe-auth/ABQHIsD8fJTSlj6d2y9CPEQ9qgJ50heAks5vEHh_gaJpZM4aFLm5> .

[jschendel]

I believe axis and order are needed to match the signature of np.argsort

Could probably update the documentation similar to Series.repeat in that case to make it more explicit that it has no effect but is accepted for compatibility with numpy.

[benjaminr]

Happy to look at updating the documentation to reflect his.