FW: [dita-users] How to start editing documents for conversion to DITA?

["Carol Geyer" <carol.geyer@oasis-open.org>]

This seems like an example of where we might want to suggest the author post to
the DITA XML.org wiki, no? Might it be a good start for our "Migrating Legacy
Content" stub page?

--c


-----Original Message-----
From: dita-users@yahoogroups.com [mailto:dita-users@yahoogroups.com] On Behalf
Of Paul Masalsky
Sent: Wednesday, January 02, 2008 11:34 AM
To: dita-users@yahoogroups.com
Subject: Re: [dita-users] How to start editing documents for conversion to
DITA?

Of the many things we did to prepare unstructured docs for conversion, I'd say
the following were the most helpful:
 
* Label all headings intended for topics with styles that indicate the intended
topic type. For example, in FrameMaker unstructured docs we had a simple
heading2 style for our level 2 headings. We changed our templates to make
several heading2 styles available (heading2concept, heading2task, etc.) so when
the docs converted, the DITA conversion programs could determine which type of
topic was desired.
 
* Try to fit all unstructured content to a DITA model. This involved moving all
conceptual information out of task topics and into concept topics, moving
tables that belong in reference topics out of concept/task topics, ensuring
that all task topics have only one main procedure, moving prerequisites into a
separate section before the main procedure in task topics, etc. etc. etc.
 
Hope this helps!
Paul Masalsky
EMC
 


Jan <brandego@yahoo.com> wrote:

	Hello and forgive me if this has been discussed to death although I
can't find it in the 
	archives. I am new to DITA and have been charged with cleaning up
legacy documents for 
	conversion to XML and DITA. I am not sure how to start this project
besides checking that the 
	major styles such as headers etc are used consistently. Does anyone
know of a template I 
	should use to organize topics? Any help gratefully appreciated.
	
	




Paul Masalsky - paulmasalsky@yahoo.com <mailto:paulmasalsky@yahoo.com> 

________________________________

Be a better friend, newshound, and know-it-all with Yahoo! Mobile. Try it now.
<http://us.rd.yahoo.com/evt=51733/*http://mobile.yahoo.com/;_ylt=Ahu06i62sR8HDt
Dypao8Wcj9tAcJ> 

__._,_.___ 
Messages in this topic
<http://groups.yahoo.com/group/dita-users/message/8538;_ylc=X3oDMTM1dnJnbnZ0BF9
TAzk3MzU5NzE0BGdycElkAzEyNzQ0MjA5BGdycHNwSWQDMTcwNjAzMDM5MARtc2dJZAM4NTM5BHNlYw
NmdHIEc2xrA3Z0cGMEc3RpbWUDMTE5OTI5MTY0NwR0cGNJZAM4NTM4> (2) Reply (via web
post)
<http://groups.yahoo.com/group/dita-users/post;_ylc=X3oDMTJxMGdqbzFkBF9TAzk3MzU
5NzE0BGdycElkAzEyNzQ0MjA5BGdycHNwSWQDMTcwNjAzMDM5MARtc2dJZAM4NTM5BHNlYwNmdHIEc2
xrA3JwbHkEc3RpbWUDMTE5OTI5MTY0Nw--?act=reply&messageNum=8539> | Start a new
topic
<http://groups.yahoo.com/group/dita-users/post;_ylc=X3oDMTJmZW9ybDFmBF9TAzk3MzU
5NzE0BGdycElkAzEyNzQ0MjA5BGdycHNwSWQDMTcwNjAzMDM5MARzZWMDZnRyBHNsawNudHBjBHN0aW
1lAzExOTkyOTE2NDc-> 
Messages
<http://groups.yahoo.com/group/dita-users/messages;_ylc=X3oDMTJmMWdrc2syBF9TAzk
3MzU5NzE0BGdycElkAzEyNzQ0MjA5BGdycHNwSWQDMTcwNjAzMDM5MARzZWMDZnRyBHNsawNtc2dzBH
N0aW1lAzExOTkyOTE2NDc->  | Files
<http://groups.yahoo.com/group/dita-users/files;_ylc=X3oDMTJnNWxrazNqBF9TAzk3Mz
U5NzE0BGdycElkAzEyNzQ0MjA5BGdycHNwSWQDMTcwNjAzMDM5MARzZWMDZnRyBHNsawNmaWxlcwRzd
GltZQMxMTk5MjkxNjQ3>  | Photos
<http://groups.yahoo.com/group/dita-users/photos;_ylc=X3oDMTJmNTBuaDg2BF9TAzk3M
zU5NzE0BGdycElkAzEyNzQ0MjA5BGdycHNwSWQDMTcwNjAzMDM5MARzZWMDZnRyBHNsawNwaG90BHN0
aW1lAzExOTkyOTE2NDc->  | Links
<http://groups.yahoo.com/group/dita-users/links;_ylc=X3oDMTJnZDI3ZDZpBF9TAzk3Mz
U5NzE0BGdycElkAzEyNzQ0MjA5BGdycHNwSWQDMTcwNjAzMDM5MARzZWMDZnRyBHNsawNsaW5rcwRzd
GltZQMxMTk5MjkxNjQ3>  | Database
<http://groups.yahoo.com/group/dita-users/database;_ylc=X3oDMTJkbWRmNWR2BF9TAzk
3MzU5NzE0BGdycElkAzEyNzQ0MjA5BGdycHNwSWQDMTcwNjAzMDM5MARzZWMDZnRyBHNsawNkYgRzdG
ltZQMxMTk5MjkxNjQ3>  | Polls
<http://groups.yahoo.com/group/dita-users/polls;_ylc=X3oDMTJnbW43cWR1BF9TAzk3Mz
U5NzE0BGdycElkAzEyNzQ0MjA5BGdycHNwSWQDMTcwNjAzMDM5MARzZWMDZnRyBHNsawNwb2xscwRzd
GltZQMxMTk5MjkxNjQ3>  | Members
<http://groups.yahoo.com/group/dita-users/members;_ylc=X3oDMTJmMm1uOHFsBF9TAzk3
MzU5NzE0BGdycElkAzEyNzQ0MjA5BGdycHNwSWQDMTcwNjAzMDM5MARzZWMDZnRyBHNsawNtYnJzBHN
0aW1lAzExOTkyOTE2NDc->  | Calendar
<http://groups.yahoo.com/group/dita-users/calendar;_ylc=X3oDMTJlNHQzZGpxBF9TAzk
3MzU5NzE0BGdycElkAzEyNzQ0MjA5BGdycHNwSWQDMTcwNjAzMDM5MARzZWMDZnRyBHNsawNjYWwEc3
RpbWUDMTE5OTI5MTY0Nw-->  
MARKETPLACE
________________________________

Earn your degree in as few as 2 years - Advance your career with an AS, BS, MS
degree
<http://us.ard.yahoo.com/SIG=12mf90v62/M=571476.12066680.12490312.11509771/D=gr
oups/S=1706030390:MKP1/Y=YAHOO/EXP=1199298847/A=5086951/R=0/SIG=12k8pu1n3/*http
://college-finder.net/index.cfm?key=yahoo_colfngrouptxt_12066680&c=CA152932587>
- College-Finder.net. 
Yahoo! Groups
<http://groups.yahoo.com/;_ylc=X3oDMTJlajRlZmsxBF9TAzk3NDc2NTkwBGdycElkAzEyNzQ0
MjA5BGdycHNwSWQDMTcwNjAzMDM5MARzZWMDZnRyBHNsawNnZnAEc3RpbWUDMTE5OTI5MTY0Nw-->  
Change settings via the Web
<http://groups.yahoo.com/group/dita-users/join;_ylc=X3oDMTJnZWU2cmc3BF9TAzk3NDc
2NTkwBGdycElkAzEyNzQ0MjA5BGdycHNwSWQDMTcwNjAzMDM5MARzZWMDZnRyBHNsawNzdG5ncwRzdG
ltZQMxMTk5MjkxNjQ3>  (Yahoo! ID required) 
Change settings via email: Switch delivery to Daily Digest
<mailto:dita-users-digest@yahoogroups.com?subject=Email Delivery: Digest>  |
Switch format to Traditional
<mailto:dita-users-traditional@yahoogroups.com?subject=Change Delivery Format:
Traditional>  
Visit Your Group
<http://groups.yahoo.com/group/dita-users;_ylc=X3oDMTJlY25paGRkBF9TAzk3NDc2NTkw
BGdycElkAzEyNzQ0MjA5BGdycHNwSWQDMTcwNjAzMDM5MARzZWMDZnRyBHNsawNocGYEc3RpbWUDMTE
5OTI5MTY0Nw--> | Yahoo! Groups Terms of Use <http://docs.yahoo.com/info/terms/>
| Unsubscribe <mailto:dita-users-unsubscribe@yahoogroups.com?subject=> 
Recent Activity

*	
	 2
	New Members
<http://groups.yahoo.com/group/dita-users/members;_ylc=X3oDMTJnaTY4ZTM2BF9TAzk3
MzU5NzE0BGdycElkAzEyNzQ0MjA5BGdycHNwSWQDMTcwNjAzMDM5MARzZWMDdnRsBHNsawN2bWJycwR
zdGltZQMxMTk5MjkxNjQ3> 

Visit Your Group
<http://groups.yahoo.com/group/dita-users;_ylc=X3oDMTJmb2lmNWhvBF9TAzk3MzU5NzE0
BGdycElkAzEyNzQ0MjA5BGdycHNwSWQDMTcwNjAzMDM5MARzZWMDdnRsBHNsawN2Z2hwBHN0aW1lAzE
xOTkyOTE2NDc-> 
Yahoo! Finance

It's Now Personal
<http://us.ard.yahoo.com/SIG=12jf2cmcc/M=493064.12016257.12445664.8674578/D=gro
ups/S=1706030390:NC/Y=YAHOO/EXP=1199298847/A=4507179/R=0/SIG=12de4rskk/*http://
us.rd.yahoo.com/evt=50284/*http://finance.yahoo.com/personal-finance> 

Guides, news,

advice & more.

Need traffic?

Drive customers
<http://us.ard.yahoo.com/SIG=12jprk5p9/M=493064.12016308.12445700.8674578/D=gro
ups/S=1706030390:NC/Y=YAHOO/EXP=1199298847/A=3848644/R=0/SIG=131l83flq/*http://
searchmarketing.yahoo.com/arp/srchv2.php?o=US2006&cmp=Yahoo&ctv=Groups5&s=Y&s2=
&s3=&b=50> 

With search ads

on Yahoo!

HDTV Support

on Yahoo! Groups
<http://us.ard.yahoo.com/SIG=12ji4c4eq/M=493064.12016258.12445665.8674578/D=gro
ups/S=1706030390:NC/Y=YAHOO/EXP=1199298847/A=4670553/R=0/SIG=11f8fj6tf/*http://
tech.groups.yahoo.com/group/samsunghd/> 

Help with Samsung

HDTVs and devices

.
 
<http://geo.yahoo.com/serv?s=97359714/grpId=12744209/grpspId=1706030390/msgId=8
539/stime=1199291647/nc1=4507179/nc2=3848644/nc3=4670553> 
__,_._,___