As I was discussing with Alex the merits of various documentation formats, I reminded myself of this quote from Philip Greenspun:
"Consider the situation of two trauma surgeons arriving at an accident scene. The patient is bleeding profusely. If surgeons were like programmers, they'd leave the patient to bleed out in order to have a really satisfying argument over the merits of two different kinds of tourniquet."