I think the problem of stuff going out of date can be avoided by giving background (why it was originally written) rather than making a commitment you can't keep about keeping it up to date.

Knowing why code was originally written can be more important than knowing what it currently does.