[
Lists Home |
Date Index |
Thread Index
]
XML.org DITA Focus Area Editorial Board,
In the interest of moving forward with our dialogue on content, I've reviewing Jen's original outline (attached again), and would
like to offer a few proposals, notes, questions, musings for the group's consideration.
1) On the left nav, we may want to create three sections. *DITA Technology* (or DITA Background or some better term) would include
all the pages created and maintained only by the Editorial Board. *DITA Community* would comprise all the wiki pages to which we
invite public input/edits (these pages would be monitored by the Editorial Board members who would remove inappropriate posts).
Finally, the *DITA Focus Area* section would provide pages with info on the site itself. So, a proposal for the left nav would look
like:
----------------------------------
DITA Technology
----------------------------------
DITA 101
Architecture
Maps
Specialization
Business case
FAQ & Fact Sheet
References
Reuse
XSL
Open Toolkit
----------------------------------
DITA Community
----------------------------------
News
Events
Best Practices
Industry Specializations
Implementations
Products
User Groups
Publications
Other Resources
----------------------------------
DITA Focus Area
----------------------------------
About
Sponsors
Editorial Board
Editorial Guidelines
Contact Us
2) The homepage should contain a basic paragraph on DITA, and a paragraph describing the purpose of the site. I don't favor
frequently changing content here, as indicated in Jen's outline.
3) For each wiki page, the Editorial Board will need to establish posting guidelines, specifying required information, word limits
for summaries and descriptions, relevance to DITA, etc.
4) *News* could contain two sections: Articles and Press Releases. Anyone could submit a DITA-related press release (headline and
brief summary, linked to the full release on an external site); it would not just be for OASIS press releases. Likewise, anyone
could submit a link to a headline/summary/link for a DITA-related article they found useful--whether from a trade publication or a
vendor site--so long as it is publicly available.
5) *Implementations* would be descriptions of actual installations. If full blown case studies are available, links could be
provided.
6) I'd like to be sure the *Products* page provides special treatment for OASIS members. For example, see
http://www.ebxml.org/tools/index.htm where we have sections for OASIS Member Products, Open Source Tools, and Other Products. Any
objection to doing that?
7) What about service providers? Should we have a separate "Services" page or just one *Solutions* page with a section for Products
and for Services? I'd like to keep the left nav as short as possible, so we don't overwhelm visitors.
8) Somewhere, we need to include links to the spec itself and to the OASIS DITA TC. I'd like to have them easily accessible, but I'd
also like to reserve the left nav links for pages within the Focus Area itself. (I think it's confusing to hit a left nav link and
go to a different web site.) Maybe we create a special box for these and/or feature them in a footer that appears on every page.
Certainly, the links to the spec and the TC should be sprinkled throughout the site's body copy.
9) The link to the *Register* page should be prominent on all Community pages, but not necessarily in the left nav.
10) The *Search* box should be prominent on all pages, but not necessarily in the left nav.
11) Jen, can you clarify what you meant by "DITA RSS" in the left nav? This may be a feature we add later.
12) Jen, what is the *DITA Definitions* page about? Is it a wiki page?
13) What do we want to do with regards to an FAQ? The OASIS TC has an FAQ, and we should certainly link to that. Do we want to have
a separate FAQ for the Focus Area? If so, what would this one accomplish that the other doesn't? I don't want redundancy if we can
help it. Should the FAQ be a wiki page? Would a forum serve this function?
14) Does "FAQ & Fact Sheet" need to be linked from the left nav? Can't these be referenced on the DITA 101 page and/or other pages?
As previously mentioned, I think we should be shooting for a brief, concise left nav. Whenever possible, new pages should branch
from the core pages in the main nav.
Well, that's my brain dump for now. Please let me know what you think.
Carol
______________________________
Carol Geyer
Director of Communications
OASIS
Voice: +1.978.667.5115 x209
-----Original Message-----
From: Jennifer Linton [mailto:jennifer.linton@comtech-serv.com]
Sent: Friday, October 21, 2005 10:59 AM
To: dita-fa-edboard@lists.xml.org
Subject: RE: [dita-fa-edboard] Progress?
Here is what I have sent out before regarding the possible content layout and what could be included. I know there is much more to
add to the spread sheet, so if everyone can include articles or information of what to be the start to each page and then send it
back, that would be great. Thanks, Jen
Jen Linton
Comtech Services, Inc.
Senior Consultant and Web Manager
710 Kipling St. Suite 400
Denver, CO 80215
P: 303-232-7586
F: 303-232-0659
-----Original Message-----
From: Don Day [mailto:dond@us.ibm.com]
Sent: Friday, October 21, 2005 7:03 AM
To: Scott Prentice
Cc: dita-fa-edboard@lists.xml.org; JoAnn Hackos
Subject: Re: [dita-fa-edboard] Progress?
Carol and Mary have apparently both been on the road during the past week for the OASIS Adoption conference in London. I agree with
Joann that it is not advisable to create potential confusion in user's minds about where to go for info--give Carol a chance to get
back in the saddle and bring us up to date on the programming and procedural setup that OASIS has been working on while she's been
out. There is always the dita-users forum as a means to post event announcements and other ephemeral news.
Scott, perhaps you haven't seen the roadmap document yet that Joann and Jennifer sent out prior to the start of this mailing list.
Jennifer, if you are reading this, would you mind sending any update of the roadmap to the list?
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
Scott Prentice
<sp@leximation.co
m>
To
JoAnn Hackos
10/20/2005 06:33 <joann.hackos@comtech-serv.com>
PM
cc
dita-fa-edboard@lists.xml.org
Subject
Re: [dita-fa-edboard] Progress?
Hi JoAnn,
Thank you for the reply and info about the upcoming meeting. I look forward being part of this as it moves forward, and helping out
as I'm able.
Thank you also for the comments regarding the ditamap.com website .. all sensible points. I've added the IBM, OASIS, and Cover Pages
links to the "latest dita release information" section on the home page. I've also added notes and revised some text to encourage
people to contribute, and point out that the site is not intended to be "all-inclusive." I would hope that it is apparent that this
is not officially endorsed by any group and is intended to be a community-supported collection of dita information. To that end, it
seems that it can be a useful tool for the dita community, at least until something better and more complete comes along
(dita.xml.org). (At which time, I'd remove any redundant information and replace it with links to dita.xml.org.)
Unless the dita.xml.org site will be available in the next couple of weeks, I think I'll send out an invitation to members of the
dita-users Yahoo list, asking people to visit the site and contribute. I'll be sure to encourage developers/contributors to add
links for their products. We may even find that some of the content can be migrated to the dita.xml.org site if appropriate.
I hope that I'm not stepping on anyone's toes by moving ahead with this .. I don't intend for this to be in competition with the
dita.xml.org site in any way. But it seems that the sooner this type of site is available, the better it will be for the dita
community.
Regards,
Scott Prentice
JoAnn Hackos wrote:
>Hi Scott,
>Yes, we missed today's meeting only because the OASIS staff just
>returned from the UK. We are scheduling a meeting for early next week
to
>review the progress of the implementation. Then, we want to develop a
>regular meeting time for the editorial board.
>
>I am concerned about urging people to visit your site only because it
>has limited content and does not clearly refer people to the XML cover
>pages, the OASIS official site, or the IBM Developer Site as containing
>"somewhat official" content. It also implies that only the tools listed
>support DITA or the only articles available are the one's you've
listed.
>
>
>I know that you haven't had an opportunity to include more content on
>your site and want people to submit content but it could be misleading.
>It may look to new visitors as if you are promoting certain
>organizations or individuals with the references. We're trying on the
>dita.xml.org to be very careful and as inclusive as we can be. For that
>reason, we've already conducted an extensive content inventory and have
>a proposed initial set of content with which to populate the new site.
>
>I've haven't heard more from Mary about the status of the development
at
>this point, but I'm assuming that work has already started at OASIS,
>based on her requirements, and we'll hear more next week.
>
>We're all anxious to get something online but at the same time, we want
>to be very fair to the entire community of contributors. Of course,
>you're free to advertise in any way you want, and I don't mean to
>suggest that you shouldn't. As I'm sure you know, there's a lot of
>misinformation already out there. I just want to be certain we don't
add
>to it as we plan the content and approach for dita.xml.org
>
>JoAnn Hackos
>
>Director
>The Center for Information Development Management 710 Kipling Street,
>Suite 400 Denver, CO 80215
>303-232-7586
>joann.hackos@comtech-serv.com
>http://www.infomanagementcenter.com
>
>
>-----Original Message-----
>From: Scott Prentice [mailto:sp@leximation.com]
>Sent: Thursday, October 20, 2005 3:04 PM
>To: dita-fa-edboard@lists.xml.org
>Subject: [dita-fa-edboard] Progress?
>
>Hi...
>
>I know I've come in to the middle of this project, and I'm sure that
>you're all working on assigned tasks and have a clear vision of where
>this is heading. I've read the requirements document sent out by Mary
>McRae, which looks quite complete, but I was wondering if any of this
is
>
>under way and where things stand. Does this group have regular
meetings?
>
>Are there other documents?
>
>Also, is there any objection to my announcing www.ditamap.com to a
wider
>
>group to make that available for use until dita.xml.org is up and
>running? Once dita.xml.org is up, I'd point people from ditamap.com to
>the appropriate location.
>
>...scott
>
>Scott Prentice
>Leximation, Inc.
>www.leximation.com
>+1.415.485.1892
>
>
>
>
>
>---------------------------------------------------------------------
>This publicly archived list is provided by OASIS for the use of the
>Editorial Board of the XML.org DITA Focus Area. 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
>Committee homepage: http://www.oasis-open.org/committees/dita
>
>
>
>
>
>
>
>
>
---------------------------------------------------------------------
This publicly archived list is provided by OASIS for the use of the Editorial Board of the XML.org DITA Focus Area. 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
Committee homepage: http://www.oasis-open.org/committees/dita
---------------------------------------------------------------------
This publicly archived list is provided by OASIS for the use of the Editorial Board of the XML.org DITA Focus Area. 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
Committee homepage: http://www.oasis-open.org/committees/dita
dita xml org.ppt
DITA resource library (dita.xml.org).xls
---------------------------------------------------------------------
This publicly archived list is provided by OASIS for the use of the
Editorial Board of the XML.org DITA Focus Area. 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
Committee homepage: http://www.oasis-open.org/committees/dita
|
