Get the latest tech news
Trolltech's Documentation Process
documentation process When I arrived at Trolltech, there wasn't much documentation for Qt. Some good intentions, some outdated Τεχ source, no plan for improvement.
With the Τεχ process, finding omissions in the documentation required cross-referencing a header file and a sheet of printout to see which functions were mentioned in one but not both. The ideal documentation tool for a programmer in the zone has hardly any features and offers no control over the output. The biggest example of that was when Eirik wrote the Qt Tutorial, a program which started as Hello World and gradually grew to chapter 14, a simple game, with line-by-line explanations along the way.
Or read this on Hacker News