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: Current trends in Authoring Tools? From:"Gordon McLean" <Gordon -dot- McLean -at- GrahamTechnology -dot- com> To:<techwr-l -at- lists -dot- techwr-l -dot- com> Date:Fri, 9 Feb 2007 07:56:23 -0000
My tuppence.
I think there needs to be a realisation that, for a lot of us who are
working in the 'public software' field, people are becoming less and less
fussy about both HOW they get their information and whether it's 100%
accurate or not.
We all spend a lot of time creating templates, which usually involves
discussions about how a list should be punctuated, how many levels of
heading are we allowed, and so on and on and on. What I'm more worried
about, these days, isn't how well the information conforms to a template (an
excellent job for a tool I'd say) but how I make sure the users can find the
information the way THEY want to. If that means dumping 1000 text files on a
web server, one per procedure, then so be it.
After all, these days, where's one of the first places you go to look for
help when you get stuck in an application? I'd suggest Google is in the top
3 for most people, no?
Of course we need to balance that against both the impact to the business
and the documentation requirements. But if my authoring tool doesn't support
me in disseminating my information the way my users want, then it's as
useless as a pencil sharpener in the desert.
Ohh and yes, being able to write well is a 'tool' too, as are many other
'non-software' skills that most of us either have or at least know we should
have. That's a different thread though (although the likelihood of THAT ever
being realised is fairly slim), or one for the "We may be technical but we
are writers first and foremost" list.
Gordon McLean
____________________________________________________________________________________________________
This email (and any attachments) is private and confidential, and is intended solely for the
addressee. If you have received this communication in error please remove it and inform us via
telephone or email. Although we take all possible steps to ensure mail and attachments
are free from malicious content, malware and viruses, we cannot accept any responsibility
whatsoever for any changes to content outwith our administrative bounds. The views represented
within this mail are solely the view of the author and do not reflect the views of the organisation
as a whole.
____________________________________________________________________________________________________
Graham Technology plc
Registered in Scotland company no. SC143434
Registered Office India of Inchinnan, Renfrewshire, Scotland PA4 9LH
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-