programming-guidelines: Use styles to indicate valid code samples

Rather than using comments at the top of the code example which could be
missed or mistaken for part of the code sample. Also remove some
extraneous whitespace and set the content type of the <code> elements.

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