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.
I have just read the thread, and have a this comment:
There used to be a reference to infomapping on the OASIS website (I don't
know if it's still there), it definitely was a source of inspiration to
the DITA guys. That being said, I recommend reading up on both structured
writing/infomapping and DITA, and combine them into sth that works for
you(r customers).
Please forget about the horizontal rules/tables/labels/etc discussion
about infomapping, layout is besides the point here.
Wouter
Peter Neilson <neilson -at- windstream -dot- net>
Sent by:
techwr-l-bounces+wouter_verkerken=mastercard -dot- com -at- lists -dot- techwr-l -dot- com
06/20/2007 01:34 PM
To
TECHWR-L <techwr-l -at- lists -dot- techwr-l -dot- com>
cc
Subject
Re: Writing structured content
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
wouter_verkerken -at- mastercard -dot- com -dot-
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.
CONFIDENTIALITY NOTICE
This e-mail message and any attachments are only for the use of the intended recipient and may contain information that is privileged, confidential or exempt from disclosure under applicable law. If you are not the intended recipient, any disclosure, distribution or other use of this e-mail message or attachments is prohibited. If you have received this e-mail message in error, please delete and notify the sender immediately. Thank you.
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
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-
