RE: [dita-fa-edboard] RE: DITA Knowledge Base reorg suggestions

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

Thoughts about the Introduction page ...

Alternative 1: The Getting Started info could stay on the Introduction
page after a quick intro to the area with bullet points. It's ok that
the bullets would be repeated at the bottom of the page. If that
approach is taken, the beginning of the page could be similar to
http://dita.xml.org/wiki-specializations

Alternative 2: Yes, it would also be viable to keep Getting Started as a
separate page and use the model of http://dita.xml.org/architecture on
the Introduction page.

Best wishes,

Bruce

-----Original Message-----
From: Carol Geyer [mailto:carol.geyer@oasis-open.org] 
Sent: Thursday, October 12, 2006 4:33 PM
To: dita-fa-edboard@lists.xml.org
Subject: [dita-fa-edboard] RE: DITA Knowledge Base reorg suggestions

I think this is done. Please check and let me know if it looks okay.

Note: On the new http://dita.xml.org/introduction, I don't like how you
have to scroll down to the bottom to see the sub links. Maybe we should
keep "Getting Started" as its own page, and just have the Introductions
page be one sentence followed by a list of the sub-links (similar to
what we do at http://dita.xml.org/architecture).

Note also: http://dita.xml.org/production-publishing is still pretty
bare. Do we want to keep this page in the KB? We can always remove it
from the nav and add it back in later.

Carol 

-----Original Message-----
From: Don Day [mailto:dond@us.ibm.com]
Sent: Thursday, October 12, 2006 3:08 PM
To: carol.geyer@oasis-open.org
Subject: DITA Knowledge Base reorg suggestions


What JoAnn, Scott, Bruce and I discussed as you were joining today:

Original:
 * DITA 101
 * Production / publishing
 * Milestones
 * FAQ / fact sheet
 * Why DITA?
 * Getting started
 * Open source toolkit
 * Topic-based authoring
 * Architecture
 * Specification

This is the main modification, with my own suggested new order on the
rest--should be vetted by the group.  The 4 child sections would no
longer
appear on the KB front page--they would be child links on the
Introduction
page.

 * Introduction to DITA (Was Getting started)
    - Milestones
    - Why DITA?
    - DITA 101
    - FAQ / fact sheet
 * Topic-based authoring
 * Architecture
 * Production / publishing
 * Open source toolkit
 * OASIS DITA Technical Committee (new)
 * Specification



Regards,
--
Don Day
Chair, OASIS DITA Technical Committee
IBM Lead DITA Architect
Email: dond@us.ibm.com
11501 Burnet Rd. MS9033E015, Austin TX 78758
Phone: +1 512-838-8550
T/L: 678-8550

"Where is the wisdom we have lost in knowledge?
 Where is the knowledge we have lost in information?"
   --T.S. Eliot


---------------------------------------------------------------------
This publicly archived list is provided by OASIS for feedback on 
the XML.org DITA Focus Area. To minimize spam in the archive, you 
must subscribe before posting. Alternatively, you may contact 
communications@oasis-open.org for direct assistance.  

[Un]Subscribe/change address: list-[un]subscribe@lists.xml.org  
List archives: http://lists.xml.org/archives/dita-fa-feedback 
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