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: Revised element reference topics -- Please take a look


If you were at the TC meeting on 18 July, you heard Robert report about the items regarding the DITA 2.0 spec that a small group discussed and the recommendations that they came up with.

I attach a PDF that includes some element reference topics that have been reworked to match the new format, which includes the following sections:

  1. Title
  2. Short description (uses natural language)
  3. Usage information
  4. Formatting expectations
  5. Processing expectations
  6. Attributes
  7. Example

Do note that these rejigged topics do not necessarily contain appropriate content for DITA 2.0, but that existing content has been moved into the relevant section, for example, "Formatting expectations". We all thought that moving content into the relevant sections would make it much easier to see what content is appropriate, what is unneeded, and where we have content that should be augmented.

The attribute sections are untouched. Normative statements have been reworked so that they are complete content that could be reused in another document or appendix.

--
Best,
Kris

Kristen James Eberlein
Chair, OASIS DITA Technical Committee
Principal consultant, Eberlein Consulting
www.eberleinconsulting.com
+1 919 682-2290; kriseberlein (skype)

Attachment: Test-element-reference-redesign.pdf
Description: Adobe PDF document



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