TechWhirl (TECHWR-L) is a resource for technical writing and technical communications professionals of all experience levels and in all industries to share their experiences and acquire information.
For two decades, technical communicators have turned to TechWhirl to ask and answer questions about the always-changing world of technical communications, such as tools, skills, career paths, methodologies, and emerging industries. The TechWhirl Archives and magazine, created for, by and about technical writers, offer a wealth of knowledge to everyone with an interest in any aspect of technical communications.
Subject:Re: The Agile / Xtreme TW From:CL T <straylightsghost -at- gmail -dot- com> Date:Mon, 9 Feb 2009 09:08:39 -0700
-Collin
Agreed.
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. http://www.doctohelp.com
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! http://www.helpandmanual.com/
---
You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-
