cosmetic changes for the documentation

* mainly scheduler related x-refs
* some capitalisation
* some other minor things