Our tech pubs group enjoyed Scott W. Ambler’s “Calculating Documentation Cruft” article in Dr. Dobb’s Journal related to Agile methods and documentation. We had some fun in an email thread and I’d like to capture some of our discussion here. Scott cleverly turns CRUFT (a geek term that either combines crust with fluff or refers […]
Writing End-User Documentation in an Agile Development Environment
This article was original published in the June 2007 issue of the CIDM Best Practices Newsletter. It is re-published in its entirety with the permission of the Center for Information Development Management. In this article, we examine an increasingly popular development methodology from the Extreme Programming family—Agile development—and how technical writers can operate successfully in […]
An outline for a passionate user guide
From “Creating Passionate Users,” Kathy Sierra follows up to her “let marketing write the manuals” post Her post on “Creating Passionate Users” is a long one but well worth reading — How to get users to RT*M. Since this is a G-rated blog, apologies for the known acronym. Let’s say it stands for “Read The […]