.. title: Documenting projects can reveal code/ design bugs. .. slug: documenting-projects-can-reveal-code-design-bugs .. date: 2016-06-30 11:20:14 UTC-07:00 .. tags: software .. category: .. link: .. description: .. type: text 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/