Annotate and document guideline.py (#809)

* Add type annotations.

* Add/improve documentation.

---------

Co-authored-by: knutnergaard <knutnergaard@users.noreply.github.com>