Agile software development and effect on techwriting

Subject: Agile software development and effect on techwriting
From: Solveig Haugland <solveig -at- techwriterstuff -dot- com>
To: techwr-l -at- lists -dot- raycomm -dot- com
Date: Tue, 13 Jan 2004 09:16:46 -0700


I'm reading a forum this week for programmers where they're talking
about agile software development. One of the tenets of Agile
programmers, I believe, is that they don't document things as they go
along programming since the docs are always out of date, etc. Also I
believe often the users are told to fiddle with prototypes and then give
feedback since that's a much more direct way of getting feedback on what
users actually want.

So in a world where you get great software at the very last minute, with
few docs along the way on the program except some UML and without a
solid UI to code to (I believe, not positive), how the heck do
techwriters do any docs without an extra two months at the end of the
process? Granted, one probably has better simpler UI so that helps. I
believe a tenet is also that you try to just use the program as the
documentation, for the programmers at least, and try to make a point of
making it easier, so that mind set, at least, one would think could
trickle down to a better clearer UI thus requiring less or less complex

Has anyone been on an agile software development project? What was the
effect if any that was different from usual?


solveig -at- techwriterstuff -dot- com
"Tell Me About the Typos When the Software Works."
Products expressing the agony and ecstacy of being a techwriter.


Previous by Author: Re: OpenOffice v StarOffice?
Next by Author: Re: Agile software development and effect on techwriting
Previous by Thread: Re: Outsourcing to Other Countries: Costs
Next by Thread: Re: Agile software development and effect on techwriting

What this post helpful? Share it with friends and colleagues:

Sponsored Ads