Re: Cheicken and eggs scenario for structred writing

Subject: Re: Cheicken and eggs scenario for structred writing
From: Chris Despopoulos <despopoulos_chriss -at- yahoo -dot- com>
To: "techwr-l -at- lists -dot- techwr-l -dot- com" <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Thu, 25 Jul 2013 02:52:24 -0700 (PDT)

Yves gives excellent advice.  One step not to skip is to generally audit your current content.  Look for compatibilities/incompatibilities...  Look for how the content should map to DITA.  You can find lots of information out there to help direct this level of the effort.

I have to second Yves' suggestion for pre-defining your procedures, concepts, reference topics if you plan to use those divisions.  Typically, you will go from a given heading level to any one of those...  That means you have a 1-to-many translation.  In effect, you're adding information into your source.  There's no way to increase the resolution without manually doing the work.  So you should go ahead and start on that.  It will teach you a lot about your content, and ties in nicely with an audit anyway.

cud


^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
New! Doc-to-Help 2013 features the industry's first HTML5 editor for authoring.

Learn more: http://bit.ly/ZeOZeQ

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

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-leave -at- lists -dot- techwr-l -dot- com


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

Looking for articles on Technical Communications? Head over to our online magazine at http://techwhirl.com

Looking for the archived Techwr-l email discussions? Search our public email archives @ http://techwr-l.com/archives


Previous by Author: Re: Taking active vs. passive voice too far
Next by Author: Re: spec writing - is simple ever wrong ?
Previous by Thread: Re: Cheicken and eggs scenario for structred writing
Next by Thread: Re: Cheicken and eggs scenario for structred writing


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


Sponsored Ads