User Documentation in Agile Development Teams

Subject: User Documentation in Agile Development Teams
From: Sue McKinney <smckinn2001 -at- gmail -dot- com>
To: techwr-l -at- lists -dot- techwr-l -dot- com
Date: Fri, 24 Mar 2017 10:40:04 -0400


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.

Any thoughts?

Sue McKinney
Visit TechWhirl for the latest on content technology, content strategy and content development |


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 for more resources and info.

Looking for articles on Technical Communications? Head over to our online magazine at

Looking for the archived Techwr-l email discussions? Search our public email archives @


Previous by Author: RE: Which skill to acquire
Next by Author: RE: For all you comma-chasers out there -- second attempt
Previous by Thread: Re: Managed Services
Next by Thread: Re: User Documentation in Agile Development Teams

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

Sponsored Ads