Cleaning up our list of articles [was: New DITA 1.2 feature article published by the DITA Adoption TC...]

["Grosso, Paul" <pgrosso@ptc.com>]

Re:

 

You also can see a complete list of the DITA 1.2 feature articles issued by the OASIS DITA Adoption Committee at http://dita.xml.org/wiki/oasis-dita-adoption-committee

Perhaps, but one is supposed to be able to see a complete list of the DITA Adoption TC's approved articles at

http://www.oasis-open.org/committees/tc_home.php?wg_abbrev=dita-adoption#expository

and I don't see this one listed there.

 

The titles listed on xml.org do not match those lists on our TC page--I don't see why not. Diving into each articles, it looks like (TC page listing on the left, xml.org on the right):

 

DITA 1.2 Feature Description: Conref Push <-> Conref push

 

DITA 1.2 Keyref: Feature Description <-> Keyref

 

Glossary Specialization - Best Practices (.doc) <-> Glossary and terminology specialization

 

DITA 1.2 Glossary and Terminology Specialization Feature Description (.pdf) <-> Glossary and terminology specialization (same as previous)

 

DITA 1.2 Referencing a Range of Elements: Feature Description <-> Conref range

 

[There is nothing on the TC page] <-> Improved glossary and terminology handling

 

 

(I was somewhat amazed to discover that two entries with quite different titles are just the .doc and .pdf version of the same article.  This needs to be cleaned up.)

 

We need to get the list on our TC page up to date, and if we are going to maintain two "complete list of the DITA 1.2 feature articles", then we need to make sure they match one another.

 

Given that our public TC page's "Expository Work Produced by the Committee" list is supposed to be the authoritative list of all our TC's work, I suggest that we should not announce a DITA Adoption TC publication until we have added it to that list.

 

Please put this issue on our agenda for next Monday's meeting.

 

paul

 

From: Kristen James Eberlein [mailto:kris@eberleinconsulting.com]
Sent: Thursday, 2010 January 28 9:16
To: dita-users@yahoogroups.com
Cc: DITA TC; DITA Adoption
Subject: [dita] New DITA 1.2 feature article published by the DITA Adoption TC: "Improved glossary and terminology handling"

 

The OASIS DITA Adoption Committee has issued another feature article about the upcoming DITA 1.2 release, authored by Tony Self, HyperWrite PTY Ltd.

This feature article focuses on "Improved glossary and terminology handling"; here is the abstract:

"DITA 1.2 introduces significant improvements to the way in which terminology is handled. A new glossary entry element provides a flexible semantic structure to store terminology information, and the new indirect linking functionality allows terms occurring in the content to be linked through a key reference or transcluded using a new abbreviated-form element. Keys used for key referencing are defined in a new glossref specialisation of topicref in the map."

The feature article's page on dita.xml.org contains a link from which you can download the PDF:
http://dita.xml.org/resource/dita-12-feature-article-improved-glossary-and-terminology-handling

You also can see a complete list of the DITA 1.2 feature articles issued by the OASIS DITA Adoption Committee at http://dita.xml.org/wiki/oasis-dita-adoption-committee