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: REquest for advice on Workflow & Tools From:Goober <techcommgoober -at- yahoo -dot- com> To:"TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com> Date:Wed, 8 May 2002 20:15:18 -0700 (PDT)
> Here's a request for input. Situation: I'm a new
> tech writer with a
> group of strategic-level software (enterprise)
> architects. they produce
> all sorts of documents...strategic vision papers,
> blueprints,
> guidelines, that sort of thing (no user manuals or
> online help). Current
> process is they use Word, send the Word around for
> comment/review, and
> ultimately publish finals in PDF on an intranet.
>
> I'm thinking of this workflow:
>
> Architect creates draft in Word 97 (standard, not
> upgradeable) --> I
> edit in Word --> Architect gets technical reviews
> --> I edit finals -->
> Architect gets approvals --> I publish with
> FrameMaker 7 and WebWorks to
> both PDF and HTML
OK, do you need to justify your existence by making
more work for yourself? Why stick with Word if you're
going to be publishing with FrameMaker? I don't get
it. Why not stick with Word then, make the PDF, and
then save as HTML like they are doing? You're not
making the workflow better... you're just adding
overhead. IMHO, of course. ;)
> Reasons for FM: Document design control, mostly, as
> well as
> single-source publishing, basic version control
> Detractions from FM: Cost, bottleneck, dependence on
> Adobe
> Reasons for Word: Architects have it, control
> changes faster, I don't
> become a publication bottleneck, no divergence of
> versions
> Detractions from Word: Shared templates don't work
> (Word does weird
> things based on writers's normal.dot's resident on
> their computers),
> numbers are a nightmare, easy for non-approved
> changes to occur
Sounds like you need to fix workflow, not jump to a
new tool. You may be able to fix your workflow without
jumping to tools, or at least by revisiting the
workflow in detail you could get an idea of how new
tools will help you. As of right now, I see no benefit
whatsoever in adding FM+WWP to your workflow.
> I'm looking for advice on workflow, cooperation, and
> also tools. Thanks!
So you can't author any of this yourself, and you
can't get the Architects to use FM? Not even if you
create "bulletproof" templates? I'm curious, is your
role only as a typesetter/publisher? I'm just curious.
I suggest revisiting the workflow. Talk to the authors
of the content and see what makes sense. Maybe you
could use SGML instead and have them write using very
finitely-defined styles and a specific structure of
elements... you could then create print and HTML from that...
__________________________________________________
Do You Yahoo!?
Yahoo! Shopping - Mother's Day is May 12th! http://shopping.yahoo.com
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Free copy of ARTS PDF Tools when you register for the PDF
Conference by April 30. Leading-Edge Practices for Enterprise
& Government, June 3-5, Bethesda,MD. www.PDFConference.com
Buy RoboHelp Office in May and you'll save $100 with our mail-in rebate.
Or switch from Doc-to-Help or ForeHelp to RoboHelp Office for only $499.
Get the help authoring tool PC magazine recently awarded a perfect score!
Go to http://www.ehelp.com/techwr
---
You are currently subscribed to techwr-l as: archive -at- raycomm -dot- com
To unsubscribe send a blank email to leave-techwr-l-obscured -at- lists -dot- raycomm -dot- com
Send administrative questions to ejray -at- raycomm -dot- com -dot- Visit http://www.raycomm.com/techwhirl/ for more resources and info.