TechWhirl (TECHWR-L) is a resource for technical writing and technical communications professionals of all experience levels and in all industries to share their experiences and acquire information.
For two decades, technical communicators have turned to TechWhirl to ask and answer questions about the always-changing world of technical communications, such as tools, skills, career paths, methodologies, and emerging industries. The TechWhirl Archives and magazine, created for, by and about technical writers, offer a wealth of knowledge to everyone with an interest in any aspect of technical communications.
In our small development group we practice a Hybrid Agile approach and
have just begun formalizing our acceptance tests. The tech writer (that
is me), QA and marketing rep join the development team to come up with
acceptance tests. Design is often formalized during these discussions.
(and yes, my input is heard and respected. I don't always 'win', but no
ones input is trivialized! With the acceptance tests in hand I can draft
user documentation. Since the developers are coding to pass the test,
fewer problems are encounterd. Testing encounters fewer show stoppers.
We also have an '80percent' review where the developers show the
functionality and the team decides on what sections may need
re-factoring. Design and Documentation doesn't change nearly as often
now. Previously we had a lot of questionable design that was re-worked
during system run thru.
It works in our environment. But then again, there are eight people
(max) attending these acceptance test meetings. In larger
organizations, it is probably much more difficult.
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
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 & 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 & Manual: http://www.helpandmanual.com
---
You are currently subscribed to TECHWR-L as archive -at- infoinfocus -dot- com -dot-
