Re: The Technical Writer vs. Agile Development Methodologies

Subject: Re: The Technical Writer vs. Agile Development Methodologies
From: Janice Gelb <janice -dot- gelb -at- sun -dot- com>
To: techwr-l -at- lists -dot- techwr-l -dot- com
Date: Wed, 01 Feb 2006 11:05:40 +1100

Tracy Taylor wrote:

Hiya -
Agile doesn't preclude reviews.

With Agile, you're trying to get one small piece of
functionality designed, coded, and ready to release in
an iteration (two or three weeks). You know the
functionality is ready to release because it meets
acceptance tests such as a code review. So a
documentation review is considered part of the
acceptance tests. They also do acceptance tests at
the release level as well.

I know every devevelopment team is different, but ours
was very open to incorporating doc processes into

Also, I found that the writers I managed got the
information they needed easiest on the teams with the
strictest Agile processes.

Oh, and by a lot of time in development meetings, I
meant about 20 hours a week.

I have never worked in the Agile system but I
suspect that it is the same as most other
development strategies in that if the developers
think documentation is important and/or respect the
writers, they will cooperate and ensure that doc
processes are incorporated. If they think that
comprehensive documentation is a waste of time or
writers are useless, then they will resist or ignore
documentation requirements or processes.

-- Janice

Now Shipping -- WebWorks ePublisher Pro for Word! Easily create online
Help. And online anything else. Redesigned interface with a new
project-based workflow. Try it today!

Doc-To-Help includes a one-click RoboHelp project converter. It's that easy. Watch the demo at

You are currently subscribed to TECHWR-L as archive -at- infoinfocus -dot- com -dot-
To unsubscribe send a blank email to techwr-l-unsubscribe -at- lists -dot- techwr-l -dot- com
or visit

To subscribe, send a blank email to techwr-l-join -at- lists -dot- techwr-l -dot- com

Send administrative questions to lisa -at- techwr-l -dot- com -dot- Visit for more resources and info.

Re: The Technical Writer vs. Agile Development Methodologies: From: Tracy Taylor

Previous by Author: Re: Items in a Series and Comma Use?
Next by Author: Re: RoboHelp Baby...and Now the Rest of the Story
Previous by Thread: Re: The Technical Writer vs. Agile Development Methodologies

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

Sponsored Ads