Various cleanup

This fixes @rizar's comment on the developer guidelines, as well as some documentation and formatting fixes to Jan's PR.
Yes, the version above works for me. But I don't understand the sentence starting from "Code is easier to read".