The document is done in Mallard markup. I’d be more comfortable with mdbook, which uses a much simpler Markdown syntax, and generates pretty web pages with some modern amenities. (I don’t want to bikeshed too much on the markup language - but while Mallard works very well for non-linear, pluggable online help, I don’t think it works well for linear, reference books like the Programming Guidelines.)
I think this is a nice effort.
Couple of suggestions:
Can we add the link to GNOME programming guidelines page, to all GNOME project wiki page under
Development / Contributesection. I am not sure how many projects have them, but it would be good to have it, as most new GNOME contributers start their work based on the information provided in the wiki of the project of their interest.
Would be nice, if we could have a PS / PDF rendered version too.
Adding rust into the doc toolchain will add some complications, I assume.