One reason why I like the show Dirty Jobs so much is because Mike Rowe, the host, is so respectful and honest about the work that people do each day. Dirty Jobs offers such a great viewpoint on work that is done each and every day. I recently discovered that Sarah Maddox, a technical writer […]
What makes a doc plan Agile?
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 […]