RE: [dita-fa-edboard] FW: [dita-users] How to start editing documents fo

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

Would it make sense for one person from the Edboard to monitor the dita-users
list and direct specific posters to XML.org when appropriate? Perhaps each
EdBoard member could take a one-month shift. 

It wouldn't be a big time commitment. There probably aren't more than a few
posts a month that would need follow-up, and I imagine most EdBoard members
monitor dita-users anyway.

--carol

-----Original Message-----
From: JoAnn Hackos [mailto:joann.hackos@comtech-serv.com] 
Sent: Wednesday, January 02, 2008 12:15 PM
To: Carol Geyer; DITA Editorial Board
Subject: RE: [dita-fa-edboard] FW: [dita-users] How to start editing documents
for conversion to DITA?

Hi Carol,
I would encourage Paul to post this. It's pretty basic but it's useful
for people who haven't thought about migration of content before.
JoAnn

JoAnn T. Hackos, PhD
President
Comtech Services, Inc.
710 Kipling Street, Suite 400
Denver, CO 80215
303-232-7586
joann.hackos@comtech-serv.com
joannhackos Skype
www.comtech-serv.com

-----Original Message-----
From: Carol Geyer [mailto:carol.geyer@oasis-open.org] 
Sent: Wednesday, January 02, 2008 9:40 AM
To: 'DITA Editorial Board'
Subject: [dita-fa-edboard] FW: [dita-users] How to start editing
documents for conversion to DITA?

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=Ahu06i6
2sR8HDt
Dypao8Wcj9tAcJ> 

__._,_.___ 
Messages in this topic
<http://groups.yahoo.com/group/dita-users/message/8538;_ylc=X3oDMTM1dnJn
bnZ0BF9
TAzk3MzU5NzE0BGdycElkAzEyNzQ0MjA5BGdycHNwSWQDMTcwNjAzMDM5MARtc2dJZAM4NTM
5BHNlYw
NmdHIEc2xrA3Z0cGMEc3RpbWUDMTE5OTI5MTY0NwR0cGNJZAM4NTM4> (2) Reply (via
web
post)
<http://groups.yahoo.com/group/dita-users/post;_ylc=X3oDMTJxMGdqbzFkBF9T
Azk3MzU
5NzE0BGdycElkAzEyNzQ0MjA5BGdycHNwSWQDMTcwNjAzMDM5MARtc2dJZAM4NTM5BHNlYwN
mdHIEc2
xrA3JwbHkEc3RpbWUDMTE5OTI5MTY0Nw--?act=reply&messageNum=8539> | Start a
new
topic
<http://groups.yahoo.com/group/dita-users/post;_ylc=X3oDMTJmZW9ybDFmBF9T
Azk3MzU
5NzE0BGdycElkAzEyNzQ0MjA5BGdycHNwSWQDMTcwNjAzMDM5MARzZWMDZnRyBHNsawNudHB
jBHN0aW
1lAzExOTkyOTE2NDc-> 
Messages
<http://groups.yahoo.com/group/dita-users/messages;_ylc=X3oDMTJmMWdrc2sy
BF9TAzk
3MzU5NzE0BGdycElkAzEyNzQ0MjA5BGdycHNwSWQDMTcwNjAzMDM5MARzZWMDZnRyBHNsawN
tc2dzBH
N0aW1lAzExOTkyOTE2NDc->  | Files
<http://groups.yahoo.com/group/dita-users/files;_ylc=X3oDMTJnNWxrazNqBF9
TAzk3Mz
U5NzE0BGdycElkAzEyNzQ0MjA5BGdycHNwSWQDMTcwNjAzMDM5MARzZWMDZnRyBHNsawNmaW
xlcwRzd
GltZQMxMTk5MjkxNjQ3>  | Photos
<http://groups.yahoo.com/group/dita-users/photos;_ylc=X3oDMTJmNTBuaDg2BF
9TAzk3M
zU5NzE0BGdycElkAzEyNzQ0MjA5BGdycHNwSWQDMTcwNjAzMDM5MARzZWMDZnRyBHNsawNwa
G90BHN0
aW1lAzExOTkyOTE2NDc->  | Links
<http://groups.yahoo.com/group/dita-users/links;_ylc=X3oDMTJnZDI3ZDZpBF9
TAzk3Mz
U5NzE0BGdycElkAzEyNzQ0MjA5BGdycHNwSWQDMTcwNjAzMDM5MARzZWMDZnRyBHNsawNsaW
5rcwRzd
GltZQMxMTk5MjkxNjQ3>  | Database
<http://groups.yahoo.com/group/dita-users/database;_ylc=X3oDMTJkbWRmNWR2
BF9TAzk
3MzU5NzE0BGdycElkAzEyNzQ0MjA5BGdycHNwSWQDMTcwNjAzMDM5MARzZWMDZnRyBHNsawN
kYgRzdG
ltZQMxMTk5MjkxNjQ3>  | Polls
<http://groups.yahoo.com/group/dita-users/polls;_ylc=X3oDMTJnbW43cWR1BF9
TAzk3Mz
U5NzE0BGdycElkAzEyNzQ0MjA5BGdycHNwSWQDMTcwNjAzMDM5MARzZWMDZnRyBHNsawNwb2
xscwRzd
GltZQMxMTk5MjkxNjQ3>  | Members
<http://groups.yahoo.com/group/dita-users/members;_ylc=X3oDMTJmMm1uOHFsB
F9TAzk3
MzU5NzE0BGdycElkAzEyNzQ0MjA5BGdycHNwSWQDMTcwNjAzMDM5MARzZWMDZnRyBHNsawNt
YnJzBHN
0aW1lAzExOTkyOTE2NDc->  | Calendar
<http://groups.yahoo.com/group/dita-users/calendar;_ylc=X3oDMTJlNHQzZGpx
BF9TAzk
3MzU5NzE0BGdycElkAzEyNzQ0MjA5BGdycHNwSWQDMTcwNjAzMDM5MARzZWMDZnRyBHNsawN
jYWwEc3
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.115097
71/D=gr
oups/S=1706030390:MKP1/Y=YAHOO/EXP=1199298847/A=5086951/R=0/SIG=12k8pu1n
3/*http
://college-finder.net/index.cfm?key=yahoo_colfngrouptxt_12066680&c=CA152
932587>
- College-Finder.net. 
Yahoo! Groups
<http://groups.yahoo.com/;_ylc=X3oDMTJlajRlZmsxBF9TAzk3NDc2NTkwBGdycElkA
zEyNzQ0
MjA5BGdycHNwSWQDMTcwNjAzMDM5MARzZWMDZnRyBHNsawNnZnAEc3RpbWUDMTE5OTI5MTY0
Nw-->  
Change settings via the Web
<http://groups.yahoo.com/group/dita-users/join;_ylc=X3oDMTJnZWU2cmc3BF9T
Azk3NDc
2NTkwBGdycElkAzEyNzQ0MjA5BGdycHNwSWQDMTcwNjAzMDM5MARzZWMDZnRyBHNsawNzdG5
ncwRzdG
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=X3oDMTJlY25paGRkBF9TAzk3N
Dc2NTkw
BGdycElkAzEyNzQ0MjA5BGdycHNwSWQDMTcwNjAzMDM5MARzZWMDZnRyBHNsawNocGYEc3Rp
bWUDMTE
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=X3oDMTJnaTY4ZTM2B
F9TAzk3
MzU5NzE0BGdycElkAzEyNzQ0MjA5BGdycHNwSWQDMTcwNjAzMDM5MARzZWMDdnRsBHNsawN2
bWJycwR
zdGltZQMxMTk5MjkxNjQ3> 

Visit Your Group
<http://groups.yahoo.com/group/dita-users;_ylc=X3oDMTJmb2lmNWhvBF9TAzk3M
zU5NzE0
BGdycElkAzEyNzQ0MjA5BGdycHNwSWQDMTcwNjAzMDM5MARzZWMDdnRsBHNsawN2Z2hwBHN0
aW1lAzE
xOTkyOTE2NDc-> 
Yahoo! Finance

It's Now Personal
<http://us.ard.yahoo.com/SIG=12jf2cmcc/M=493064.12016257.12445664.867457
8/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.867457
8/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.867457
8/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> 
__,_._,___ 


---------------------------------------------------------------------
This publicly archived list is provided by OASIS for the use of the
Editorial
Board of DITA XML.org. Subscription and posting privileges are reserved
for
members of the Editorial Board; others should contact
communications@oasis-open.org for assistance.

[Un]Subscribe: dita-fa-edboard-[un]subscribe@lists.xml.org
List archives: http://lists.xml.org/archives/dita-fa-edboard/
XML.org DITA Focus Area: http://dita.xml.org
Committee homepage: http://www.oasis-open.org/committees/dita
List Guidelines: http://www.oasis-open.org/maillists/guidelines.php




---------------------------------------------------------------------
This publicly archived list is provided by OASIS for the use of the Editorial
Board of DITA XML.org. Subscription and posting privileges are reserved for
members of the Editorial Board; others should contact
communications@oasis-open.org for assistance.

[Un]Subscribe: dita-fa-edboard-[un]subscribe@lists.xml.org
List archives: http://lists.xml.org/archives/dita-fa-edboard/
XML.org DITA Focus Area: http://dita.xml.org
Committee homepage: http://www.oasis-open.org/committees/dita
List Guidelines: http://www.oasis-open.org/maillists/guidelines.php