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 an ideal world, yes. In actuality, not so much.
Granted, I'm speaking from a startup mentality. John's subsequent post
went into details about larger efforts and the necessity for keeping all
related groups and projects apprised of progress and so forth, all of
which I agree with. Another illustration of why smaller companies are
more responsive (and usually more fun).
But back to the small world scenario. The same thing never happens
twice, so developing a process that depends on specific inputs and
actions and so forth is almost useless. At one end of the scale you can
get larger truths written down, but they sound like this:
* Marketing commits to a deliverable to a customer in exchange the
the money that will pay our salaries at the end of the quarter.
* Development determines the minimum amount that they have to do to
meet the deliverable in time for the deadline.
* Documentation figures out what they have create, revise, and
remove by the deadline,.
* QA figures out how late they have to work the week before the
deadline to get the code tested and maybe glance at the doc.
Now, as to what constitutes the "Documentation figures out what they
have create, revise, and remove by the deadline" portion - that's what
they pay me the big bucks for. That, and sitting in development meetings
to get the scoop on what they're planning on doing, telling them what is
out of the question to document by the deadline, hounding the
developers for information, getting my hands on each days build to see
what's new and changed, and developing docs that reflect the reality of
it all.
I love it.
My 2¢,
John Garison
(Who can tell he'd enjoy working with Elizabeth)
John Posada wrote:
... what's important is that you know what you are doing,
what you will be doing next, at what percentage of the project each
element should happen, and that you follow the same process each time.
WebWorks ePublisher Pro for Word features support for every major Help
format plus PDF, HTML and more. Flexible, precise, and efficient content
delivery. Try it today! http://www.webworks.com/techwr-l
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