Archive for the ‘agile’ Category:

Structured Wikis and Software Engineering – Documentation Throughout the Process

{ Posted on Nov 04 2008 by annegentle }
5 Comments
Tags : , , , , , , , , ,
Categories : DITA, agile, techpubs, wiki
Lisa Dyer and I have co-authored another paper about structured wikis, using DITA as the structure for the wiki. The paper contains specific ideas about using wikis both internally and externally for software engineering processes and software documentation. Our assertion is ...Read More »

Reading lists for technical writing

{ Posted on Jun 17 2008 by annegentle }
12 Comments
Tags : , , , ,
Categories : agile, techpubs
As a graduate student in scientific and technical communication, I was fortunate to have been introduced to many texts for learning technical writing at Miami University in Ohio. I have kept those books, keeping them on my bookshelf wherever I ...Read More »

April 16 Central Texas DITA User Group meeting

{ Posted on Apr 09 2008 by annegentle }
No Comments
Tags : , , , , ,
Categories : DITA, agile
From http://dita.xml.org/book/central-texas-dita-user-group Using DITA Content for Learning Content Development John Hunt, of IBM, will give a presentation regarding the use of DITA for learning content. He's been working on a new Learning and Training Content specialization that will be part of OASIS ...Read More »

How to be an Agile Technical Writer with a cool acronym like XTW

{ Posted on Feb 19 2008 by annegentle }
2 Comments
Tags : , , , , , , ,
Categories : agile
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 ...Read More »

What makes a doc plan Agile?

{ Posted on Aug 04 2007 by annegentle }
3 Comments
Tags : , , , , , , ,
Categories : agile, techpubs
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 ...Read More »

Making the documentation cruft calculation more user-friendly

{ Posted on Aug 01 2007 by annegentle }
No Comments
Tags : , , , , , , , , , , ,
Categories : agile, techpubs, writing
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 ...Read More »

Writing End-User Documentation in an Agile Development Environment

{ Posted on Jul 02 2007 by annegentle }
28 Comments
Tags : , , , , , , , , , , , , , , , , , ,
Categories : agile
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 ...Read More »

Wiki for tech pubs – ready for main dish status? Or still undercooked or side dish material?

{ Posted on Jun 26 2007 by annegentle }
6 Comments
Tags : , , , , , , , , ,
Categories : agile, wiki
I've been doing some research for an article for the STC Intercom based on the interview I did with a friend of mine who does maintenance on the MOTO Q wiki. The article will come out this fall and I ...Read More »