News for hackers. Stuff that matters.
Re:Making Code Easy to Understand – What Developers Want (a ... by chc on Thursday July 28, 2011 @01:05PM (#2817765)
Technically, all the code in your program could rightly be called a "code example." But it's not very good for determining how to use the code in your program. Test cases are closer to being good code examples, but they're still generally optimized for checking correctness rather than illustrating use. If nothing else, a good, complete set of test cases will be full of distracting noise.

There are no comments on this comment yet.