Re: User Documentation in Agile Development Teams
I am a long-time tech writer very familiar with Waterfall development and^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
am now getting familiar with Agile. I understand the idea behind lean
documentation for what I call "back-end" documentation (e.g., requirements,
user stories, design) but am trying to learn more about getting end user
documentation into the development cycle. It's tough, given the frequent
releases, and I now am faced with push-back from managers and developers
claiming that documentation is way less important in Agile. In fact, it's
just as important! Even though the software is supposed to "intuitive,"
we're finding out that users want assistance; we're in the middle of
creating online help for a second release of something that was deemed
intuitive enough to not require online help for the first release. And
then, of course, users complained about not know how to get their work
done. I'm looking for ways to identify best practices for user
documentation (online help, user guides) to present to management so that
the new writer alone on a project has more credibility when he or she
argues in favor of, say, online help.
Visit TechWhirl for the latest on content technology, content strategy and content development | http://techwhirl.com
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-
To unsubscribe send a blank email to
techwr-l-leave -at- lists -dot- techwr-l -dot- com
Send administrative questions to admin -at- techwr-l -dot- com -dot- Visit
http://www.techwhirl.com/email-discussion-groups/ for more resources and info.
Looking for articles on Technical Communications? Head over to our online magazine at http://techwhirl.com
Looking for the archived Techwr-l email discussions? Search our public email archives @ http://techwr-l.com/archives
References:
User Documentation in Agile Development Teams: From: Sue McKinney
Previous by Author:
Re: Managed Services
Next by Author:
Re: A question for the list in general
Previous by Thread:
Re: User Documentation in Agile Development Teams
Next by Thread:
RE: User Documentation in Agile Development Teams
Search our Technical Writing Archives & Magazine
Visit TechWhirl's Other Sites
Sponsored Ads