"Clarity" is not a substitute for comments. The only thing I've seen that really substitutes for comments is a rich, easy to understand unit test suite. But eve

"Clarity" is not a substitute for comments. The only thing I've seen that really substitutes for comments is a rich, easy to understand unit test suite. But even that is problematic, as it usually covers a lot of edge and corner case situations that aren't relevant to the end user.