Re: [dita-fa-edboard] Please prepare for next DITA XML.or call!

[Scott Prentice <sp@leximation.com>]

Hi Carol...

I can't make it to the next call .. I'll be in XSLT classes all of next 
week.

I've taken a look at the Wiki TOC and the KB TOC to offer my suggestions 
as to how they could be integrated. I think the Wiki TOC seems like a 
good starting place, although I think we'll need an "About DITA" group 
(or some such heading) for some of the KB items that don't really fit 
elsewhere. I'm fine with the page I wrote being available for others to 
edit.

Here's my initial pass at where the KB TOC items should go .. use it (or 
not) as you see fit. The "=>" indicates the mapping to a Wiki TOC entry.

-------------------------------
    * Introduction  => About DITA > Introduction (new entry)
        - Getting started
        - DITA 101
        - Milestones
        - Why DITA?
        - FAQ / fact sheet

    * Topic-based authoring  => About DITA > Topic-based authoring (new 
entry)

    * Architecture  => About DITA > Architecture (new entry)
        - Introduction to the DITA Architecture
        - DITA Topics and Information Typing
        - DITA Maps
        - Specialization
        - Content referencing (conref)
        - Conditional processing

    * Production / publishing  => About DITA > Production / publishing 
(new entry .. or should this go under "Publishing with the DITA Open 
Toolkit" ?)

    * Open source toolkit  => Working with DITA > Publishing with the 
DITA Open Toolkit (maybe?)

    * OASIS DITA Technical Committee  => Official stuff > OASIS DITA 
Technical Committee (new entry)

    * Specification => (I'm not sure how useful this page is in its 
current form .. ??)

    * Archive of <soapbox> feature articles  => About DITA > Archive of 
<soapbox> feature articles (new entry)
-------------------------------

BTW .. did y'all see the blog entry about the site?

    
http://thecontentwrangler.com/printer/ditaxmlorg_would_someone_call_the_housekeeper_please/

Seems a little harsh to me, but everyone is entitled to their opinion.

Cheers,

...scott




Carol Geyer wrote:
> Our next EdBoard call is on Thursday, 13 Sept, at 2:00 EST. (We meet on the
> second Thursday of the month.)
>
> Before that call, please take a moment to review the message I sent out after
> last month's meeting (below).
>
> -Are we happy with the ToC at http://dita.xml.org/wiki? If not, please edit it.
>
> -Are there pages in the Knowledge base that we don't want to let others edit
> wiki-style? If you are the author of one of these pages, please follow
> instruction #1 below *before* our next call.
>
> -Are there pages in the Knowledge base that fit logically in the new wiki ToC?
> If so, let's be prepared to discuss where they should go (and move them) on our
> next call.
>
> -Are there pages in the Knowledge base that don't fit logically in the Toc? If
> so, how do we edit the ToC to include them?
>
> It would be great if we could complete an integration of the KB and Wiki
> sections on our next call.
>
> I've also asked Jamie Clark to join the call and address issues regarding
> posting the DITA spec for comments on XML.org.
>
> Thanks,
> Carol
>
>
> -----Original Message-----
> From: Carol Geyer [mailto:carol.geyer@oasis-open.org] 
> Sent: Thursday, August 09, 2007 4:05 PM
> To: 'DITA Editorial Board'
> Subject: [dita-fa-edboard] New ToC up on DITA XML.org wiki
>
> I've added Su-Laine's ToC to http://dita.xml.org/wiki.  (The old wiki
> links are still on that page, just scroll down.) I've created new placeholder
> pages for each of the areas Su-Laine identified. (Drupal is adding a "?" in the
> URL paths; I'll have Neil check into that.)
>
> Hopefully, we can begin to edit that ToC now. Freelinking is working, so
> You can create links to new pages by using the double brackets.
>
> We can also begin to integrate the KB pages:
>
> 1. Authors should first identify pages they do *not* want to integrate
> into the wiki, i.e., pages you created that you don't want others to edit. I
> Would suggest most of these should be re-submitted in the Resources directory
> As articles. To do that, copy the text and submit it using the form at
> http://dita.xml.org/node/add/resource. You can link to your article from the
> appropriate Wiki page if you like.
>
> 2. We'll probably want to move some KB pages intact into Su-Laine's existing
> Wiki outline. (For example, the oasis-tc page should probably be a new page
> under "Official stuff".) For other KB pages, we may want to copy and
> Paste portions of text into the existing new Wiki pages.
>
> Please let me know if you experience any problems.
>
> Carol
>
>
>
>
>
>
> ---------------------------------------------------------------------
> 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
>
>
>
>
>