RE: Creating content for DITA Learning SC

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

Bruce,
It's great to see this coming along. I know Mary and Don have weighed in on the
TC wiki issue, so I'll address the rest.

1. Any TC member may join the DITA XML.org Editorial Board, so John Hunt and
Scott Hudson are certainly welcome.

The Editorial Board could choose to extend editor privileges to any OASIS
member (or just to any member of the OASIS DITA TC and/or SCs) upon request,
without requiring people to be active participants on the Board. (OpenDocument
does that now.) The only risk is that someone might edit a KB page
inappropriately, but should that happen, it would be easy to revert back (and
identify the "culprit"). I'm inclined to go with trust here; what do others on
the Board think?


2. Looks good, thanks.


3. You're right, of course. I was trying to collect common Focus Area pages
into a central location, so I wouldn't have to worry about consistency, but
that project has been temporarily sidetracked. I'll adjust the link from About
until I have time to revisit this.

Should we add a Forum for Learning Content? 


--c

-----Original Message-----
From: Esrig, Bruce (Bruce) [mailto:esrig@lucent.com] 
Sent: Wednesday, October 18, 2006 7:45 AM
To: Carol Geyer
Cc: dita-fa-edboard@lists.xml.org; john_hunt@us.ibm.com;
scott.hudson@flatironssolutions.com
Subject: Creating content for DITA Learning SC

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