[pojzon]

IMHO writing a well-documented code requires a discipline and a set of good habbits.

One of those habbits is to update documentation (tests/comments) when software is evolving.

Unfortunately it is a very rare habbit it seems.