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.
>On the GUI: Several have tried but none have succeeded, IMHO. The
>problem is that WYSIWYG is the defacto standard for doc editing in most
>people's minds. Any UI modeled on WYSIWYG principles won't work with
As some may have gathered from my previous posts, I document
a software SDK/API using LaTeX. I work as the only dedicated
"docs guy" among a team of around a dozen software developers.
The developers all need to either
* access / update the real docs (latex, i.e., plain text with
semantic/logical markup which is easier to read than
* provide me with draft material in whatever form they
feel happy with for me to markup in latex
Some developers happily write latex into the main docs
in perforce, others grab latex and edit it but don't check it
back in or attemp to build the docs from it, others are
Word-only-WYSIWYG-ers who send me some bumph
to tart up.
A couple of these guys (one in particular) is particularly
pathologically set against LaTeX. He says he'd be happy
if there was a good GUI, but really there isn't.
I have a long term plan to move to xml/simplified Docbook.
It seems to me the tools for xml/docbook are becoming pretty
usable. However finding an editor that this guy will be
comfortable using will be an issue. I had hoped that
a suitable IDE type almost WYSIWYG (WYSIWYM perhaps)
editor, which presents _a reasonably small number of
possible tags_ at any given point, would be ideal
(it would need wysiwyg editing of tables also as
that seems to be an issue in this person's head).
Any suggestions? (other than no-more-mr-nice-guy, get
his boss to kick his backside?). What I don't want, is for
this guy to end up keeping his own "personal" version of
"his" docs which he keeps up to date in Word, and the
"official" docs (which I edit in some system he dislikes)
becoming rapidly obsolete.
Christopher Gooch, Technical Author
LightWork Design, Sheffield, UK.
chris -dot- gooch -at- lightworkdesign -dot- com www.lightworkdesign.com
Experience RoboHelp X3! This new RoboHelp release combines single sourcing,
print-quality documentation, conditional text and much more, into the most
monumental release of RoboHelp ever! http://www.ehelp.com/techwr-l
Enhance, optimize and automate your FrameMaker-to-PDF workflow with TimeSavers:
Define all PDF features in your source FrameMaker files ONCE, distill MANY.
Bookmark Controller, Link Controller, UnBloat & more : http://www.microtype.com
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.