Update the (partial)sortperm docs (#27169)
* Remove incorrect keyword from partialsortperm documentation
* Comment on guaranteed stability of sortperm irrespective of algorithm
* Add examples to partialsortperm and comment about guaranteed stability
* Remove 'alg' keyword from partialsortperm signature in docs.