draft solution -- for review only -- do not merge!

@haf while this is not valid Ruby (which I do not master), this will hopefully allow you to get the ideas of the proposed solution. Your comments are appreciated. 
the templates are effectively project specific. They define details of the html rendering of your project docs. if you reuse templates of another projects, you need to pass the template substitution parameters via `--parameters`