A bonus to writing documentation

A quick observation:

There is nothing quite like writing up the documentation for a new feature you've just programmed to poke you into realizing just how lame your quick implementation is, and spur you into doing a better, less limited version. Somehow it is just hard to put the limits of a quick hack down in the black and white of text; making the limitations explicit makes them all the more cringe-worthy and petty.