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.
Subject:Re: AW: How do hiring companies view TW resumes? From:Chris Despopoulos <despopoulos_chriss -at- yahoo -dot- com> To:techwr-l -at- lists -dot- techwr-l -dot- com Date:Wed, 24 Mar 2010 04:58:05 -0700 (PDT)
Design docs are usually measured by meeting predictable deadlines. They're considered a part of project management, and so are measured by that standard. But here's one of my soap boxes... Tech writers can and should provide more value than merely producing pages of user documentation. Organizing and clarifying the design process is a whopping-huge opportunity for adding value. It resists outsourcing, and it gets the writer directly involved at the very start of the project. And it fits well with Agile.
On your resume you would say something like, "I managed and maintained the design documents (ooo... maybe even designed them?) for the X project. Our team met every milestone on or before deadline. Our product generated X revenue."
**********************
On design documents such as use cases or requirement docs, here's an
idea: the cost of bugs can be quantified as the payroll cost of the
rework time needed to fix them. Some of those bugs will result not from
programming or database mistakes, but from the design docs not being
followed properly. Those are what I call procedure-fail bugs. Sift the
bug reports and identify the procedure-fail bugs. Then claim that if
the docs had been read and followed in the first place, the company
could have saved the rework costs of those procedure-fail bugs.
**********************
Use Doc-To-Help's XML-based editor, Microsoft Word, or HTML and
produce desktop, Web, or print deliverables. Just write (or import)
and Doc-To-Help does the rest. Free trial: http://www.doctohelp.com
Explore CAREER options and paths related to Technical Writing,
learn to create SOFTWARE REQUIREMENTS documents, and
get tips on FUNCTIONAL SPECIFICATION best practices. Free at: http://www.ModernAnalyst.com
---
You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-