OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.


Help: OASIS Mailing Lists Help | MarkMail Help

dita message

[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

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 Yeo
Interaction Design Specialist 
JustSystems Canada, Inc.
Office: 778-327-6356 

-----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

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

I have attached a PDF2 version of the document with Acrobat Reader
commenting enabled. MS HTML Help and TOCJSBIS versions are available at:


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.

Stan Doherty
DITA Help Subcommittee, Secretary

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]