Update search command docs

[shahar1]

Fixes: #12059

[chrysle]

Please see #12207 (comment) concerning removing the whole docs.

[shahar1]

Please see #12207 (comment) concerning removing the whole docs.

I see, so it may be better to restore the content and add the deprecation comment regarding the PyPi index?
IMO there is a place for some clarification about that in the docs as the issue's OP suggests.

[chrysle]

I see, so it may be better to restore the content and add the deprecation comment regarding the PyPi index?

I think that is what is suggested in the issue.

[pradyunsg]

Thanks for filing this! I have a few suggestions, to align better with the style of the rest of the documentation and to fix a couple of minor inconsistencies with the situation here.

[shahar1]

@pradyunsg Thanks for the review, adopted your suggestions :)

[chrysle]

I think the usage should be kept?

[JamesParrott]

Thanks @shahar1 and @pradyunsg. Much appreciated :).