Creating content for DITA Learning SC

["Esrig, Bruce \(Bruce\)" <esrig@lucent.com>]

Hi Carol,

 

John Hunt, Scott Hudson, and I created a little tree of pages for the DITA Learning Content Subcommittee (SC).

 

You can see our progress at http://dita.xml.org/wiki-LearningContentSC, its subordinate pages (three links in the list of questions), and the See also pages.

 

1. For now, these pages are on the wiki. That will let the entire SC add info to them. (Oh, maybe a better way is to make them Knowledge Base pages and temporarily open up the permissions on those pages.) There's a big note under Editorial Guidelines stating that the work of the SC would be done at the main OASIS site, so I'd like to confirm that the following policy is ok. The SC pages at dita.xml.org are for capturing and reporting publicly-visible status. We've still got the SC wiki at the main OASIS site for working information such as the agenda, and we would still use the e-mail list for contributions.

 

(Thinking ahead ...) It's possible that John Hunt and Scott H. would want to join the editorial board. Scott H. has already written a message about that to the communications e-mail address. I'd imagine that there will be at least a technical requirement for people such as SC chairs and secretaries to have editorial permissions to edit pages once they move to the Knowledge Base. And it appears that an editor can put a wiki page into "the book" using a drop-down menu. Does that simultaneously change the permissions ... oh, probably not ... can the permissions change be done separately and manually using the permissions settings on the page? I might regret putting "wiki-" in the URLs ... I'm still looking for some way that a user can know whether they're in the Knowledge Base, DITA Today, or DITA wiki just by looking at the page.

 

2. While explaining how to add new pages, I mentioned some rules that needed to be documented. To capture that, I added some info under Editorial Guidelines. See About -> Editorial Guidelines and its subordinate pages. Also the main pages for DITA Today and the wiki (the only substantive change on those two pages is to add a sentence referring to the Editorial Guidelines and the Style Guide).

 

3. Also, as far as page navigation is concerned, the About link in the top right corner goes to a different location from the About section in the lower right. The upper right goes to a common set of policies for the XML.org online communities. The lower right goes to the dita.xml.org version. As far as I can tell, the dita.xml.org version is (now) more mature and consistent than the common set. So some reconciliation is needed. The common policy area takes the reader out of the DITA site, and I'd rather stay within the DITA site, but perhaps as the number of sites grows, that would be unmanageable.

 

Best wishes,

 

Bruce