another pass on the documentation of generators

This commit refines the docs contributed in f074bb6:

* Fixes the links to point to this repo.

* Uses fixed-width font for files and template variables, according to the overall style in the docs.

* Mentions YAML "front-matters" instead of "headers", also following the terminology in the docs ("header" is used in the source code).

* Assorted rewordings.