Re: Xtreme Programming / Agile Development and Documentation

Subject: Re: Xtreme Programming / Agile Development and Documentation
From: Tony Markos <ajmarkos -at- yahoo -dot- com>
To: HSC Italian <twins398 -at- hotmail -dot- com>, techwr-l -at- lists -dot- techwr-l -dot- com
Date: Sat, 19 Nov 2005 08:38:52 -0800 (PST)


As a Technical Writer, I want as firm of a functional
specification as possible. And, of course, the most
comprehensive and rigorous functional specs are model

The problem with Xtreme programming is that the
espoused functional specification technique is
something called a User Story. A User Story is kind
of like a Use Case, but is even more lossey- goosey
(i.e, lacking in built-in integration provisions and
comprehensivness checks) - and a Use Case is pretty
darn lossey-gossey!

At least a Use Case is somewhat of a modeling
technique. A User Story is typically just a few
sentences of text. (Holly forced, artifical
partitioning Batman!)

Try tying a bunch of text statements together to come
up with a comprehensive, integrated whole (to serve as
the basis for organizing your docs)!! The
understanding that a User-Story-based functional
specification is going to give me is going to be very


* Be aware of the issue and be able to explain it to

* Wait till you have a prototype and document off of
that (vs. planning your work off of pre-prototype

Tony Markos

--- HSC Italian <twins398 -at- hotmail -dot- com> wrote:

> Hello,
> Has anyone else out there worked, as the writer, in
> a development
> environment that uses the Xtreme Programming / Agile
> method? The developer I
> work with are using this. I know nothing about it
> and find it useless, which
> is likely due to my lack of understanding.
> If anyone has been the tech writer for a project
> where the Xtreme
> programming mehtod was used, and have ANY insight on
> a process for
> documentation, or how I could learn how to work in
> this environment better,
> that would be much appreciated.
> TIA,
> Heidi

Start your day with Yahoo! - Make it your home page!

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 2005 now has RoboHelp Converter and HTML Source: Author
content and configure Help in MS Word or any HTML editor. No
proprietary editor! *August release.

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

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


Xtreme Programming / Agile Development and Documentation: From: HSC Italian

Previous by Author: Re: Editorial/Press Release - What are some points to consider while writing?
Next by Author: Re: Xtreme Programming / Agile Development and Documentation
Previous by Thread: Xtreme Programming / Agile Development and Documentation
Next by Thread: Re: Xtreme Programming / Agile Development and Documentation

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

Sponsored Ads

Sponsored Ads