Re: [dita-fa-edboard] New wiki page: 12013 design

[Kristen James Eberlein <keberlein@pobox.com>]

Hi, Michael:

I agree with your suggestions. But help me out -- how could an 
unfamiliar user know that this Wiki page is associated with the section 
devoted to the Toolkit?

When I look at the page (and I am not logged in), all I can see is that 
it is a Wiki page:


There is nothing that clues me into the fact that it is associated with 
the DITA Open Toolkit section of the Knowledgebase:

DITA OT

Is it that people adding Wiki pages need to do the following? (I'm still 
learning how this site works ...)

1) Edit the main Knowledgebase Wiki page to point to the new Wiki page 
that they have added
2) Add a link to the new Wiki page that they have added to point back to 
the parent page listed on the main Knowledgebase page?

FYI, I tried to edit the title of "12013 design," but could not do so.

Kris

Kristen James Eberlein


Michael Priestley wrote:
>
> I think the content should be clearer as to its purpose/location 
> (right now no navigational context to show where it's coming from). 
> But is there a problem with hosting toolkit design discussions at 
> dita.xml.org? I know the toolkit team made the move explicitly to make 
> the design discussion more open to community participation, and I 
> think their motives are good. And they're building it in the right 
> part of the wiki, ie in the section devoted to the DITA Open Toolkit.
>
> I'd suggest something like "DITA Open Toolkit Design: Feature xxxx" - 
> plus add a link to the parent topic at the bottom of the page.
>
> Michael Priestley
> Lead IBM DITA Architect
> mpriestl@ca.ibm.com
> http://dita.xml.org/blog/25
>
>
> *Kristen James Eberlein <keberlein@pobox.com>*
>
> 06/16/2008 07:51 PM
>
> 	
> To
> 	Carol Geyer <carol.geyer@oasis-open.org>
> cc
> 	"'DITA Editorial Board'" <dita-fa-edboard@lists.xml.org>
> Subject
> 	Re: [dita-fa-edboard] New wiki page: 12013 design
>
>
>
> 	
>
>
>
>
>
> Hi, Carol.
>
> I think this page -- and a similar one for 12017 -- will confuse many
> readers. Both refer to specific features that will be part of DITA 1.2.
>
> My guess is that the content of http://dita.xml.org/wiki/12013-design 
> is about how the Open Toolkit will need to be modified to support 
> these new features; is there perhaps another more appropriate location 
> for this sort of content than the Wiki pages for dita.xml.org?
>
> Kris
>
>
>
> Carol Geyer wrote:
> > See http://dita.xml.org/wiki/12013-design
> >
> > I find this new page confusing, but maybe that's a sign of my own 
> ignorance. Can anyone on the EdBoard suggest adding some kind of 
> context that would make the page more useful or is it self-explanatory 
> to our readers?
> >
> > --c
> > _________________________________
> > Carol Geyer
> > Director of Communications
> > OASIS
> > +1.978.667.5115 x209
> >
> >
> > ---------------------------------------------------------------------
> > 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
> >
> >
> >
> >  
>
>
>
> ---------------------------------------------------------------------
> 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
>
>