Re: Writing structured content

Subject: Re: Writing structured content
From: Peter Neilson <neilson -at- windstream -dot- net>
To: TECHWR-L <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Wed, 20 Jun 2007 07:34:36 -0400

Single-sourcing through document re-use in its lesser forms used to
present the text of the printed manual's pages as help screens, or
perhaps vice-versa. It was justified as being easier to maintain than
constructing a user-targeted help system.

Allow me to quote myself from yesterday:

"The key is to focus on the user view and not on the technology. ... Any
time that implementation is put ahead of design, or design ahead of
requirements, the wrong minds are in control."

Does single-sourcing help meet the customer's needs? Perhaps it makes
revised documents available faster. Or perhaps it inserts non-sequiturs
into formerly comprehensible text. Perhaps it does both.
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Create HTML or Microsoft Word content and convert to Help file formats or
printed documentation. Features include support for Windows Vista & 2007
Microsoft Office, team authoring, plus more.
http://www.DocToHelp.com/TechwrlList

True single source, conditional content, PDF export, modular help.
Help & Manual is the most powerful authoring tool for technical
documentation. Boost your productivity! http://www.helpandmanual.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-unsubscribe -at- lists -dot- techwr-l -dot- com
or visit http://lists.techwr-l.com/mailman/options/techwr-l/archive%40web.techwr-l.com


To subscribe, send a blank email to techwr-l-join -at- lists -dot- techwr-l -dot- com

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


Follow-Ups:

References:
RE: Writing structured content: From: Simon North

Previous by Author: Re: how long does "fixing" a document take
Next by Author: Re: Cellular terminology
Previous by Thread: RE: Writing structured content
Next by Thread: RE: Writing structured content


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


Sponsored Ads