> keep your code and your docs closely knit It is hard. Most people I know try to replace comments with very descriptive variable and method names - that are e

> keep your code and your docs closely knit It is hard. Most people I know try to replace comments with very descriptive variable and method names - that are easy to change in any IDE. On the other hand comments (and other docs) sooner or later turn into misinformation/lie, unless you have very disciplined developers, all of them.