After a quick browse, I wouldn't recommend this book either. In Chapter 11, it makes this recommendation: Comments are valuable in only a small number of ca

After a quick browse, I wouldn't recommend this book either. In Chapter 11, it makes this recommendation: Comments are valuable in only a small number of cases. Helpful API documentation can be such a case, but always be cautious to avoid dogmatic boilerplate commentary. In general, the best advice we can give is to keep your code free of comments. I'm all for eliminating worthless comments, but self-documenting code is still a myth.