Docwork

some improvements to the documentation

fix some see also links, add missing pieces to some docstrings.

There is still more to do, but GLM has open PRs that will cause conflicts.
don't try to sneak in a change to the code in a DOC PR