Documenting projects can reveal code/ design bugs.

Stumbled upon this LWN.net entry written by a Linux man-pages contributor. The main point of this article was, documenting software projects quite early on can reveal important design and code bugs. This presented three examples of how a feature in inotify call was introduced, but was found not working while documenting it. Similar example was given for splice and timerfd calls

Read the full article here: http://lwn.net/Articles/247788/