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>
To: techwr-l -at- lists -dot- techwr-l -dot- com
Date: Sun, 18 Feb 2007 01:30:19 -0500

Yet another dev manager unclear on the concept. Good specifications, written before the product is developed, state exactly what is to be built and how. Yes, sometimes the specs have to be changed to work around a particular problem, and the spec doc should be updated with that new info, but if the specs are continually changing, you're asking the dev team to hit a moving target. I don't know anyone outside of a Wild West Show who is good at doing that. If they don't know what the spec of the final product is until the product is finished, that's the least of their problems.

I have worked with organizations that knew how to write, and develop to, specifications. It is eminently possible, and results in a good final product and no team burnout. The problem is that many development organizations really don't know how to manage development.

Ned Bedinger wrote:

Another after-the-fact document is the specification that gets written after product development is completed. A dev manager once candidly explained these to me: How could they possibly know what the specification of the final product is, unless the product is already finished?
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

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. http://www.DocToHelp.com/TechwrlList

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: http://www.helpandmanual.com

---
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 http://lists.techwr-l.com/mailman/options/techwr-l/archive%40infoinfocus.com


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
http://www.techwr-l.com/techwhirl/ for more resources and info.


Follow-Ups:

References:
Agile, SCRUM and Technical Writing: From: Gillespie, Terilyn
Re: Agile, SCRUM and Technical Writing: From: Gene Kim-Eng
Re: Agile, SCRUM and Technical Writing: From: Peter Neilson
Re: Agile, SCRUM and Technical Writing: From: Ned Bedinger

Previous by Author: Re: Agile, SCRUM and Technical Writing
Next by Author: Re: working with an inexpereinced writer
Previous by Thread: Re: 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