[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]
Subject: RE: [dita] FOR YOUR REVIEW AND APPROVAL: DITA Help Technologies Guide
I'll add this to the Agenda for today for discussion and subsequent action
based on the discussion. I do believe that the TC should have the
opportunity to speak in support of materials that are aligned with DITA's
proper usage, and to have opportunity to correct potentially misleading
messages, as we have done in the past for some early translation-related
materials.
Regards,
--
Don Day
Chair, OASIS DITA Technical Committee
Architect, Lightweight DITA Publishing Solutions
Email: dond@us.ibm.com
11501 Burnet Rd. MS9033E015, Austin TX 78758
Phone: +1 512-244-2868 (home office)
"Where is the wisdom we have lost in knowledge?
Where is the knowledge we have lost in information?"
--T.S. Eliot
From: stan@modularwriting.com
To: "Su-Laine Yeo" <su-laine.yeo@justsystems.com>, stan@modularwriting.com,
dita@lists.oasis-open.org
Cc: dita-help@lists.oasis-open.org, sdoherty@verivue.com, "Tony Self"
<tself@hyperwrite.com>
Date: 03/10/2009 08:43 AM
Subject: RE: [dita] FOR YOUR REVIEW AND APPROVAL: DITA Help Technologies Guide
Hi Su-Laine --
In terms of what is or is not appropriate procedurally for DITA Technical
Committee approval of a DITA Subcommittee (SC) document, I defer entirely
to the TC Chair, the TC, and OASIS.
In terms of this proposed subcommittee publication and others in the
pipeline (preceding and following), I can provide some context ... at least
from my perspective. :-)
Subcommittees should seek approval from their parent TC(s) before they
publish documents for at least three reasons:
1. Sanity check -- Does this proposed publication conform to the goals of
the
subcommittee? Is it appropriate?
2. Sanity check -- Does the proposed publication offer value to the target
community? In this case our audience consists of Help authors who use
DITA as their source.
3. Endorsement -- Does the proposed publication reflect positively on the
overall mission of the TC? Would members of the TC promote this
publication in their respective organizations?
The DITA Help SC has updated the TC on its proposed DITA 1.2 and DITA 1.3
goals and activities numerous times:
- DITA 1.2:
> Get organized
> Survey the state of DITA-authored Help
> Educate DITA users about existing solutions (this publication)
- DITA 1.3:
> Continue to educate folks about existing solutions
> Identify and develop specializations and custom processing
that would advance the feature set and usability of
DITA-authored Help.
Before your email last evening, all the feedback that I have received has
been supportive of the content in the DITA Help Technologies Guide and of
approving it at our TC meeting today. There are a couple of nice-to-have
production edits and nice-to-do build improvements (notably DITA 1.2 and
DITA-OT1.5 M11), but otherwise what is before the TC represents the best
effort of the Help Subcommittee. I continue to recommend that we discuss
and approve it today.
Thanx,
Stan
----- Original Message -----
From: "Su-Laine Yeo"
To: stan@modularwriting.com, dita@lists.oasis-open.org
Cc: dita-help@lists.oasis-open.org, sdoherty@verivue.com, "Tony Self"
Subject: RE: [dita] FOR YOUR REVIEW AND APPROVAL: DITA Help Technologies
Guide
Date: Mon, 9 Mar 2009 18:07:57 -0700
I should rephrase my earlier comment: I can see this type of document as
being valuable, but I am unconvinced that an OASIS committee should
publish this kind of document. I've read the DHSC Statement of Purpose
here:
http://www.oasis-open.org/committees/tc_home.php?wg_abbrev=dita-help and
I don't see how this draft guide fits.
Su-Laine
Su-Laine Yeo
Interaction Design Specialist
JustSystems Canada, Inc.
Office: 778-327-6356
syeo@justsystems.com
www.justsystems.com
-----Original Message-----
From: Su-Laine Yeo [mailto:su-laine.yeo@justsystems.com]
Sent: Monday, March 09, 2009 3:09 PM
To: stan@modularwriting.com; dita@lists.oasis-open.org
Cc: dita-help@lists.oasis-open.org; sdoherty@verivue.com; Tony Self
Subject: RE: [dita] FOR YOUR REVIEW AND APPROVAL: DITA Help Technologies
Guide
Thanks Stan. I can see this type of document as being valuable, and I am
glad the Help Subcommitee took the initiative.
However, I question the value of having the DITA TC give their approval
of this document. What is "approval" by the TC intended to convey to
the public who reads the document? The TC members are not necessarily
experts in the technologies described in this guide. Much of the factual
information in the draft guide is impossible for individual DITA TC
members to test and verify for themselves in a reasonable timeframe, as
verification would depend on extensive experience with a very wide range
of technologies, some of which are expensive and some of which have not
yet been released. The guide also contains predictions along the lines
of, "Such and such a group will be using technology x in the future",
which we obviously also cannot verify.
Another thing that "approval" could mean is that the TC considers the
opinions expressed in the document, and the amount of emphasis given to
various products, to be free of bias towards particular vendors. I am
not at all convinced that this is true; the fact that some
product-specific sections are written by people who work for the product
vendor would indicate otherwise.
It's great that you've given the TC the opportunity to review this
document, however the word "approval" is problematic for me.
Best regards,
Su-Laine
Su-Laine Yeo
Interaction Design Specialist
JustSystems Canada, Inc.
Office: 778-327-6356
syeo@justsystems.com
www.justsystems.com
-----Original Message-----
From: stan@modularwriting.com [mailto:stan@modularwriting.com]
Sent: Monday, February 23, 2009 10:43 AM
To: dita@lists.oasis-open.org
Cc: dita-help@lists.oasis-open.org; sdoherty@verivue.com; Tony Self
Subject: [dita] FOR YOUR REVIEW AND APPROVAL: DITA Help Technologies
Guide
Hi all --
The DITA Help Subcommittee submits for your review and approval Release
1.0 of our DITA Help Technologies Guide. We appreciate that members of
the TC are swamped with DITA 1.2 specification work, but we hope that we
could get your approval of this document in two weeks time (Tuesday,
March 10). We plan to update this Guide every 3 - 4 months to keep it
current.
I have attached a PDF2 version of the document with Acrobat Reader
commenting enabled. MS HTML Help and TOCJSBIS versions are available at:
http://www.oasis-open.org/apps/org/workgroup/dita-help/documents.php
Check out the nifty OASIS-branded HTML that Tony Self (Help Subcommittee
chair) has integrated with his WinANT tool.
If someone with write privileges to the Adoption TC email list could
forward this email and attachment, we would appreciate it.
Thanx,
Stan Doherty
DITA Help Subcommittee, Secretary
---------------------------------------------------------------------
To unsubscribe from this mail list, you must leave the OASIS TC that
generates this mail. Follow this link to all your TCs in OASIS at:
https://www.oasis-open.org/apps/org/workgroup/portal/my_workgroups.php
[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]