Amazing Article!
I must confess I read the title, I thought: "Yet another article asking to comment our code a lot (which is a huge code smell)".
On the contrary, this article documents how to write down LIVE documentation. The one that is always updated and lives with the code.
This documentation is so important on big systems.
Chapeau!