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.
Well, if someone reads something 'wrong' it means it wasn't clear enough in the first place, i'll edit it a bit.