Re: The Technical Writer vs. Agile Development Methodologies

[Tony Markos <ajmarkos -at- yahoo -dot- com>]

Gene:

I disagree with that article.  The goal is not to
create simple models - it is to create essential
models.  I worked on a large-scale Agile Development
project where the simple models where but Post It
notes stuck to the bosses door.  Simple - yes, but the
lack of rigor in this approach resulted in a large
number of essential requirements being missed until
much latter in the development process - and requiring
a 1000 X more time to fix.

The article also specifically espouses use of UML
modeling techniques.  Sorry to say it, but the UML
techniques strongly retard a focus on the essential. 

Tony Markos

--- Gene Kim-Eng <techwr -at- genek -dot- com> wrote:

BTW, for anyone looking for something more "official"
about the role of tech writers in the Agile
environment,
here is something that may be of interest from

http://www.agilemodeling.com/essays/agileDocumentation.htm#StrategiesForAgileDocumentation
 
"Get someone with writing experience.  Technical
writers bring a lot to the table when it comes time to
write documentation because they know how to organize
and present information effectively."
 
Scroll down to #12, "Strategies for increasing the
agility of documentation."
> 
> Gene Kim-Eng 


__________________________________________________
Do You Yahoo!?
Tired of spam?  Yahoo! Mail has the best spam protection around 
http://mail.yahoo.com 
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

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! http://www.webworks.com/techwr-l

Doc-To-Help includes a one-click RoboHelp project converter. It's that easy.  Watch the demo at http://www.componentone.com/TECHWRL/DocToHelp2005

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