Mention sorting by stars in docs (was: document api search and sorting)

Adds docs for search and sorting - this has been in for a little while, it was just left undocumented because I thought I might tune/change the search indexing a bit. Happy to commit to this though.