Re: Recommendations on Authoring Tools

Subject: Re: Recommendations on Authoring Tools
From: Julie Stickler <jstickler -at- gmail -dot- com>
To: Technical Writing <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Thu, 15 Sep 2016 10:53:05 -0400

I'll be the first to say it, what are you trying to do?

Because my tool might not fit your needs. We all have our favorites, but
they all serve different purposes. Recommending a complex tool chain that
only exists on Linux and requires programmer support to generate output is
useless if you have a small .NET shop where everyone is going to be
contributing to the doc set. Or if you need to produce JavaHelp and the
tool I recommend doesn't produce that output. Or suggesting a tool that's
best for print output when your trying to produce an online knowledgebase.

The first step in migrating from a tool is to define your requirements.
What are you documenting? (hardware, software, API, mobile app, etc.) What
outputs (printable/online/embedded) do you want to produce? What platforms
are you working and publishing on? How large is your doc set? How many
products and writers will be using the tool? Are they professionals or
will non technical writers be contributing? Will you be localizing? Et
cetera.

Start with the requirements. Then pick the tool that most closely meets
them.

You may even find that your current tool is the right one for the job, if
the person who chose it did their homework properly

On Thu, Sep 15, 2016 at 7:33 AM, Alec Chakenov <alec -dot- chakenov -at- gmail -dot- com>
wrote:

> Hello, we are planning to move from Author IT to some other authoring tool.
> What authoring tool are you using and would you recommend it?
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
> Visit TechWhirl for the latest on content technology, content strategy and
> content development | http://techwhirl.com
>
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> You are currently subscribed to TECHWR-L as jstickler -at- gmail -dot- com -dot-
>
> To unsubscribe send a blank email to
> techwr-l-leave -at- lists -dot- techwr-l -dot- com
>
>
> Send administrative questions to admin -at- techwr-l -dot- com -dot- Visit
> http://www.techwhirl.com/email-discussion-groups/ for more resources and
> info.
>
> Looking for articles on Technical Communications? Head over to our online
> magazine at http://techwhirl.com
>
> Looking for the archived Techwr-l email discussions? Search our public
> email archives @ http://techwr-l.com/archives
>



--
Julie Stickler
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Visit TechWhirl for the latest on content technology, content strategy and content development | http://techwhirl.com

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-

To unsubscribe send a blank email to
techwr-l-leave -at- lists -dot- techwr-l -dot- com


Send administrative questions to admin -at- techwr-l -dot- com -dot- Visit
http://www.techwhirl.com/email-discussion-groups/ for more resources and info.

Looking for articles on Technical Communications? Head over to our online magazine at http://techwhirl.com

Looking for the archived Techwr-l email discussions? Search our public email archives @ http://techwr-l.com/archives


References:
Recommendations on Authoring Tools: From: Alec Chakenov

Previous by Author: Re: Interesting Article on Pay and Hiring
Next by Author: Re: Recommendations on Drawing Programs?
Previous by Thread: Recommendations on Authoring Tools
Next by Thread: RE: Recommendations on Authoring Tools


What this post helpful? Share it with friends and colleagues:


Sponsored Ads