Auto merge of #25625 - bluss:doc-slice-order, r=Gankro
Auto merge of #25625 - bluss:doc-slice-order, r=Gankro

collections: Reorder slice methods to improve API docs

We have an evolutionary history whose traces are still visible in the
slice docs today.

Some heuristics:

* Group method and method_mut together
* Group method and method_by together
* Group by use case, here we have roughly:

  Basic interrogators (len)
  Mutation (swap)
  Iterators (iter)
  Segmentation (split)
  Searching (contains)
  Permutations (permutations)
  Misc (clone_from_slice)

jashank/rust,gifnksm/rust,pelmers/rust,KokaKiwi/rust,philyoon/rust,cllns/rust,XMPPwocky/rust,pshc/rust,XMPPwocky/rust,krzysz00/rust,graydon/rust,aepsil0n/rust,aidancully/rust,mvdnes/rust,TheNeikos/rust,krzysz00/rust,carols10cents/rust,dwillmer/rust,nwin/rust,graydon/rust,robertg/rust,zachwick/rust,zachwick/rust,krzysz00/rust,robertg/rust,aneeshusa/rust,zubron/rust,philyoon/rust,andars/rust,andars/rust,vhbit/rust,pshc/rust,omasanori/rust,KokaKiwi/rust,andars/rust,seanrivera/rust,seanrivera/rust,jashank/rust,l0kod/rust,graydon/rust,mvdnes/rust,reem/rust,KokaKiwi/rust,robertg/rust,mihneadb/rust,pelmers/rust,pshc/rust,dwillmer/rust,kwantam/rust,TheNeikos/rust,dwillmer/rust,aepsil0n/rust,cllns/rust,vhbit/rust,dwillmer/rust,cllns/rust,jashank/rust,seanrivera/rust,sae-bom/rust,pelmers/rust,carols10cents/rust,zubron/rust,pshc/rust,graydon/rust,ejjeong/rust,mvdnes/rust,carols10cents/rust,zachwick/rust,carols10cents/rust,GBGamer/rust,pelmers/rust,omasanori/rust,kwantam/rust,mihneadb/rust,seanrivera/rust,philyoon/rust,jroesch/rust,graydon/rust,sae-bom/rust,ejjeong/rust,TheNeikos/rust,mvdnes/rust,nwin/rust,robertg/rust,GBGamer/rust,GBGamer/rust,mihneadb/rust,reem/rust,cllns/rust,dwillmer/rust,pelmers/rust,carols10cents/rust,zubron/rust,ejjeong/rust,nwin/rust,TheNeikos/rust,zachwick/rust,gifnksm/rust,pshc/rust,pshc/rust,zubron/rust,krzysz00/rust,aneeshusa/rust,jashank/rust,aidancully/rust,robertg/rust,zubron/rust,dwillmer/rust,GBGamer/rust,jroesch/rust,jashank/rust,mihneadb/rust,philyoon/rust,aepsil0n/rust,reem/rust,andars/rust,jashank/rust,aneeshusa/rust,nwin/rust,robertg/rust,mvdnes/rust,TheNeikos/rust,graydon/rust,jroesch/rust,ejjeong/rust,nwin/rust,jroesch/rust,omasanori/rust,zubron/rust,KokaKiwi/rust,l0kod/rust,cllns/rust,pshc/rust,vhbit/rust,vhbit/rust,vhbit/rust,l0kod/rust,ejjeong/rust,andars/rust,aidancully/rust,pshc/rust,zachwick/rust,XMPPwocky/rust,nwin/rust,jroesch/rust,sae-bom/rust,aneeshusa/rust,krzysz00/rust,mihneadb/rust,vhbit/rust,aepsil0n/rust,l0kod/rust,omasanori/rust,l0kod/rust,XMPPwocky/rust,gifnksm/rust,KokaKiwi/rust,seanrivera/rust,jroesch/rust,reem/rust,reem/rust,krzysz00/rust,omasanori/rust,aidancully/rust,zachwick/rust,l0kod/rust,pelmers/rust,ejjeong/rust,sae-bom/rust,carols10cents/rust,andars/rust,jashank/rust,dwillmer/rust,mihneadb/rust,TheNeikos/rust,kwantam/rust,vhbit/rust,reem/rust,nwin/rust,GBGamer/rust,aneeshusa/rust,GBGamer/rust,mvdnes/rust,jroesch/rust,omasanori/rust,nwin/rust,jroesch/rust,sae-bom/rust,KokaKiwi/rust,gifnksm/rust,aepsil0n/rust,aidancully/rust,aneeshusa/rust,GBGamer/rust,philyoon/rust,zubron/rust,XMPPwocky/rust,GBGamer/rust,dwillmer/rust,kwantam/rust,kwantam/rust,philyoon/rust,l0kod/rust,aepsil0n/rust,cllns/rust,gifnksm/rust,gifnksm/rust,l0kod/rust,jashank/rust,sae-bom/rust,XMPPwocky/rust,zubron/rust,vhbit/rust,kwantam/rust,aidancully/rust,seanrivera/rust