Re: The Agile / Xtreme TW

Subject: Re: The Agile / Xtreme TW
From: CL T <straylightsghost -at- gmail -dot- com>
Date: Mon, 9 Feb 2009 09:08:39 -0700



Agile/XP is one of those "things" you either DO or do not. It doesn't work
"half-assed". Stories are the key to everything. Documentation is simply one
of the stories.

As for the writer being left out of the loop? That's why I always advise
"get your foot in as many doors as early as possible". Even though Tech
Writers have been around a while, there still seems to be a need for
Training. Companies, developers, engineers, managers, etc. need to know how
to work with us from time to time. Documentation and knowledge of products
does not appear by magic or osmosis.

On Mon, Feb 9, 2009 at 12:17 AM, Michael West <WestM -at- conwag -dot- com> wrote:

> >From: Peter Neilson <neilson -at- windstream -dot- net>
> >My slight experience with agile-like development has suffered from some
> >of the usual diseases that keep the writer out of the loop.
> I really don't see how that can happen if the user assistance requirements
> are captured and tracked like all the other requirements; i.e., as User
> Stories.
> And the other great benefit of User Stories, properly written, are that
> collectively they give you the topic headings for your user assistance
> material. No need to translate obtuse functional specs into user-focused
> topics, because User Stories ARE user-focused topics.
> But maybe what you refer to as "Agile-like" development is to Agile
> development as near-beer is to beer.

ComponentOne Doc-To-Help 2009 is your all-in-one authoring and publishing
solution. Author in Doc-To-Help's XML-based editor, Microsoft Word or
HTML and publish to the Web, Help systems or printed manuals.

Help & Manual 5: The complete help authoring tool for individual
authors and teams. Professional power, intuitive interface. Write
once, publish to 8 formats. Multi-user authoring and version control!

You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -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 admin -at- techwr-l -dot- com -dot- Visit for more resources and info.

Please move off-topic discussions to the Chat list, at:


Re: The Agile / Xtreme TW: From: Michael West

Previous by Author: Re: Storyboarding for an Established Application
Next by Author: Re: editing text in Flash movie
Previous by Thread: Re: The Agile / Xtreme TW
Next by Thread: RE: The Agile / Xtreme TW

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

Sponsored Ads