Laura, thanks so much for doing this. It is a really helpful page and I hope will encourage more doc contributors. I appreciate your jumping through all those hoops to get the software (Forrest?) running so you could work on the pages. Reminds me of the pain I went through getting svn installed on my Solaris system so I could edit DITA! (I got lots of help from David Van Couvering on that.)
I was thinking that you might want to use the conceptual distinction between structural and body tags and make two separate Tagging Examples tables. It might make them more manageable for users navigating them, as they get added to. The table currently doesn't have much in the way of body tags (just codeph and xref), so I expect you are planning to add some of the other common ones like varname, cite, userinput, systemoutput, term). We probably also want to have a policy statement encouraging people to use semantic tags like those and to avoid tags that only specify format (like b, i, tt, u). Are the templates actually checked in? I just did an svn update on the trunk (for docs) but no templates directory showed up. The table entry on index entries says, "When there is an Information Center, the index terms are added as metadata to help in searching for content in the Information Center." I am not sure what an Information Center is. Is it possibly something specific to IBM? (Like http://publib.boulder.ibm.com/infocenter/cscv/v10r1/index.jsp.) There is a minor typo ("lable") in the Note entry. Thanks again for your great work! Kim Laura Stewart wrote On 11/02/06 20:46,: > On 11/1/06, Laura Stewart <[EMAIL PROTECTED]> wrote: > >>On 11/1/06, Kim Haase <[EMAIL PROTECTED]> wrote: >> >>>I've been thinking it may be useful to divide the recommended tags into >>>two categories -- structural tags and body tags might be appropriate >>>terms. There are structural elements like lists, paragraphs, tables, and >>>the like; and there are tags that you use in text within these >>>structural elements, like codeph, term, varname, filepath, and so on. >>>Does that seem helpful? >>> >>>Kim >>> >>> >> >>This is a great idea! I'll implement that on the Web page. >>-- >>Laura Stewart >> > > > Kim - I added some content to the Derby Documentation site. > When you get a chance, please look over the content on these pages. > I tried to capture what we have discussed in this thread, and want to > have another pair of eyes look over the content for completeness. >
