Getting a Programmer to Document

Getting a programmer to document their code is about as difficult as giving a porcupine a back rub.  It can be done just as long as you don’t annoy the porcupine too much.

Doxygen makes it easy and convenient to embed the documentation, has a simple enough structure most programmers won’t get overwhelmed, and only adds 10% to 20% overhead.

The way to get them to keep it up to date?   Insist that you’ll only do code reviews from the documents!