programming-guidelines: Move documentation section to its own page

It isn’t really anything to do with C coding style, and can be expanded.

https://bugzilla.gnome.org/show_bug.cgi?id=376123