Add documentation for the nextSearchTerm function

* Add documentation and example for the new `nextSearchTerm` function.
* Fix a typo: `paramters` to `parameters`. 
* Cosmetic changes: add dots, colons and upper case chars where required in order to maintain consistency.