Does working in an Agile development environment change the documentation plan, or user information plan? For many writers, the purpose of a doc plan is to inform the stakeholders what you (or your team) intends to deliver for docs for a particular product release and when you will meet key milestones. Here’s an outline of […]
Making the documentation cruft calculation more user-friendly
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 […]