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.
Re: Rant... please let me help you fix the user interface
Subject:Re: Rant... please let me help you fix the user interface From:"Simon North" <sintac -at- home -dot- nl> To:Mike Starr <mike -at- writestarr -dot- com> Date:Fri, 23 Mar 2007 19:20:11 +0100
Hooooo boy!
My heart bleeds for you Mike.
I followed a simple path at my current gig; except that our software
has non-Windows, proprietary interface and the original docs were
written by the QA manager - so they are/were totally software-oriented
and read more like specs than user docs (except we don't have specs).
Can you imagine a Dreamweaver help project where every single file is
in a separate directory and they are ALL called 'index.htm'?
The major difference is that I was lucky enough to be given the chance to
'put my money where my mouth was' and come up with some suggestions. I
put a lot of effort into making a full-scale presentation to my boss, who was
fortunately impressed enough to make me repeat it to all of R&D, and I now
get to help with the development of the GUI and do a formal usability
evaluation of all products and projects. Of course, it sounds simple put like
this, but the process took nearly 2 years and we have an awful long way to
go yet.
The only suggestions I might give that could be of any use are: 1) don't give
up! 2) take it one (small) battle at a time 3) pictures speak louder than
words ... and some a few good 'reductio ad absurbam' of existing gaffes can
win a lot of converts.
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- web -dot- techwr-l -dot- com -dot-