Living Documentation

But code only tells you how things work. It doesn’t tell you why they should work the way they do, or how they are actually supposed to work.

David Leal on Writing Living Documentation