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.
Bottom-up: First type/classify information into topics --> then your
wrap it into a package
In this sense, DITA allows you to physically classify and write your
information according to topic types (procs, concepts, references). Only
later do you concern yourself with how the information will be presented
(ie grouping topics to form a chapter, which can be easily done through
XSLT). All of this spells enhanced opportunities to reuse topics,
possibly across multiple logical chapters in different document sets.
Using DITA, information becomes more granular and flexible.
Top-down: First define a package --> then squeeze the information into
the packaged mold.
In DocBook's case, you physically encapsulate your information in
chapters, articles, etc in the following order. After you have decided
whether you're writing an <article>..or..wait..maybe it's a
<chapter>...then you proceed to create the meat of the information.
Finally you hope that the structure you started with suffices for your
project. IMHBOMO, Docbook's great if you've got a publishing deal with
SAMS. I find however that it may require more massaging than DITA does
for single sourcing. Docbook has been good to those who use it and is
certainly better supported than DITA.
This is just my rant valued at $.02. For more info/points of view stay
tuned to this or maybe later threads and don't forget to google!
"The finest language is mostly made up of simple unimposing words."
From: John Cornellier
Sent: Wednesday, August 17, 2005 6:31 AM
Hi, would you please elaborate on what is meant by top-down vs
bottom-up? Or point me to a URL where someone already has?
(This e-mail may be privileged and/or confidential, and the sender does not waive any related rights and obligations. Any distribution, use or copying of this e-mail or the information it contains by other than an intended recipient is unauthorized. If you received this e-mail in error, please advise me (by return e-mail or otherwise) immediately.
Ce courriel est confidentiel et protege. L'expediteur ne renonce pas aux droits et obligations qui s'y rapportent. Toute diffusion, utilisation ou copie de ce message ou des renseignements qu'il contient par une personne autre que le (les) destinataire(s) designe(s) est interdite. Si vous recevez ce courriel par erreur, veuillez m'en aviser immediatement, par retour de courriel ou par un autre moyen. )
Now Shipping -- WebWorks ePublisher Pro for Word! Easily create online
Help. And online anything else. Redesigned interface with a new
project-based workflow. Try it today! http://www.webworks.com/techwr-l
You are currently subscribed to techwr-l as:
archiver -at- techwr-l -dot- com
To unsubscribe send a blank email to leave-techwr-l-obscured -at- lists -dot- techwr-l -dot- com
Send administrative questions to lisa -at- techwr-l -dot- com -dot- Visit http://www.techwr-l.com/techwhirl/ for more resources and info.