Re: Agile, SCRUM and Technical Writing

Subject: Re: Agile, SCRUM and Technical Writing
From: Beth Agnew <beth -dot- agnew -at- senecac -dot- on -dot- ca>
Date: Fri, 16 Feb 2007 11:34:27 -0500

I would seriously doubt the validity of the research design if these were the conclusions. Having detailed requirements, i.e., knowing exactly where you're going, can only be a "leading cause of failure of IT projects" when people don't adhere to them. The fact that they mention change management suggests that the requirements were changed but the changes weren't managed. THAT will certainly lead to project failure.

This quotation raises some serious questions about how these studies were conducted. And certainly how they're being interpreted.

In both principle and practice, I think Agile development is a good thing, but like all methodologies it has to be managed and controlled, and the right roles assigned. In much of agile and extreme programming the documentation is left in the hands of the developers, and we know this is wrong. The user stories are a great idea, but techwriters need to be involved in that phase as well. Agile is an attempt to put the control of development into the hands of the developers; unfortunately development is not a one-department process.

Many of us have been doing "just in time" documentation for years!

Gillespie, Terilyn wrote:

Scott Ambler, from tells us: "One study
found that the creation of detailed requirements documents early in a
project and the change management procedures associated with doing so is
the leading cause of failure on IT projects. Another study found that
the creation of detailed design models had no effect on the success of a
software development."


Create HTML or Microsoft Word content and convert to Help file formats or printed documentation. Features include single source authoring, team authoring,
Web-based technology, and PDF output.

Now shipping: Help &amp; Manual 4 with RoboHelp(r) import! New editor,
full Unicode support. Create help files, web-based help and PDF in up
to 106 languages with Help &amp; Manual:

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 admin -at- techwr-l -dot- com -dot- Visit for more resources and info.

Agile, SCRUM and Technical Writing: From: Gillespie, Terilyn

Previous by Author: Re: Selling a team on the technical writing job role
Next by Author: Re: Agile, SCRUM and Technical Writing
Previous by Thread: Agile, SCRUM and Technical Writing
Next by Thread: Re: Agile, SCRUM and Technical Writing

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

Sponsored Ads