creating user guides in an agile environment

Lea Rush lea at astoria-pacific.com
Fri May 15 10:29:21 PDT 2015


We don't use a pure Agile process, but I do find that Sales prefers a shorter time once the software is ready for release. I develop the documentation as software development progresses. I have to redo sections, but I can also get the documentation to them much more quickly at the end. YMMV.

Lea

Lea Rush
Software and Documentation Specialist
Astoria-Pacific
www.astoria-pacific.com<http://www.astoria-pacific.com/>
P: 800-536-3111, +1-503-657-3010

Please consider the environment before printing this email. `·.¸¸.·´¯`·.¸.·´¯`·...¸ ><((((º>`·.¸¸.·´¯`·.¸.·´¯`·...¸><((((º>

NOTICE OF CONFIDENTIALITY

This communication is from Astoria-Pacific and is intended to be confidential and solely for the use of the persons or entities addressed above.  If you are not an intended recipient, be aware that the information contained herein may be protected from unauthorized use by privilege or law, and any copying, distribution, disclosure, or other use of this information is prohibited.  If you have received this communication in error, please contact the sender by return email or telephone (503) 657-3010 immediately, and delete or destroy all copies.  Thank you for your cooperation.

From: framers-bounces at lists.frameusers.com [mailto:framers-bounces at lists.frameusers.com] On Behalf Of Johnson, Joyce
Sent: May 15, 2015 9:17 AM
To: framers at lists.frameusers.com
Subject: creating user guides in an agile environment

All -

Is anyone writing software user guides for end users in an environment in which the software is being developed following agile guidelines? If so, are you writing portions of the user guide at each software iteration? How do you handle major revisions to the software? That is, if you wrote a section of the user guide on the deliverables produced in the first iteration, then learned that the software you wrote about changed in the 4th iteration, what did you do? How did that affect your timeline? Do you find writing in iterations more beneficial than waiting until the software is in a more finished state?

Thanks in advance for any feedback.

Joyce

jjohnson at abtg.com<mailto:jjohnson at abtg.com>


CONFIDENTIALITY NOTICE: This electronic mail transmission may contain privileged and/or confidential information and is intended only for the review of the party to whom it is addressed. If you have received this transmission in error, please immediately return it to the sender, delete it and destroy it without reading it. Unintended transmission shall not constitute the waiver of the attorney-client or any other privilege.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.frameusers.com/pipermail/framers-frameusers.com/attachments/20150515/38028963/attachment.htm>


More information about the framers mailing list