The generally entertaining The Daily WTF recent had a nice, more serious than usual article Documentation Done Right about the role of documentation in the development process. Particularly relevant to my Systems Analysis class is the discussion at the end about the role of diagramming, as well as the acknowledgement of the dangers of documentation when that documentation is inaccurate. Provocative quote: “Less complete documentation is generally better all around.”
But if you haven’t thought a lot about why documentation is necessary in the world of “self-documenting code”, it’s worth a look. And the weblog in general is a fun browse.
Glimpses of the websurfing habits of a computer science professor, obsessive crafter, occasional gamer, and all around geek