Merge: Document the doc/ directory

The directory is empty except an outdated README.
So, maybe not the best user-experience for people that look for documentation and naively open the `doc/` directory...

So update the README and offer a `Makefile` to generate something in the directory.

Pull-Request: #942
Reviewed-by: Alexandre Terrasa <alexandre@moz-code.org>