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: Giving up on XML From:Ned Bedinger <doc -at- edwordsmith -dot- com> To:quills -at- airmail -dot- net Date:Wed, 14 Mar 2007 09:36:45 -0700
> Technical writing using structure to produce coherent documents. If
> you don't structure your documents, you are unorganized, and your
> documents will reflect that. Your customers will probably not be able
> to use your documents.
>
I think this results in a lot of make-work. I prefer to formulate the
tech writer's mission as revealing the structure of information, not
structuring documents. When you structure documents, you're presumably
offering the reader a logical or predictable presentation of the
information. That information has its own structure, and you can easily
bollix the task by forcing it into another one.
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-