Hi, TC folks.
You can go to the following URL and download a PDF of the
element-reference topics that are included in this review of
the element-reference topics that exist in both DITA and LwDITA:
https://www.oasis-open.org/committees/document.php?document_id=64078&wg_abbrev=dita
Review the PDF, and then enter your comments in DITAweb at https://ditaweb.com/oasis-dita
You will need to log into the application and navigate to the
publication:
(If you need help resetting your password, contact Alan Houser or
me.)
Here are our objectives for this review
- Review the rewritten -- in natural language -- short
description. The short description is intended to be reused in
both DITA and LwDITA specifications.
- Get familiar with the new structure of the element-reference topic and its key sections:
- Short description
- Usage information
- Formatting expectations
- Processing expectations
- Attributes
- Examples
- Is the content now in the "Formatting expectations" and
"Processing expectations" appropriate and complete? Is there
material that needs to be added? Can these sections be used in
both the DITA and LwDITA specifications?
- Are the examples of high quality?
Note: The review contains hyperlinked cross references to
attributes topic. Do not comment on those topics at this
point.
Best,
Kris
Kristen James Eberlein
Chair, OASIS DITA Technical Committee
Principal consultant, Eberlein Consulting
www.eberleinconsulting.com
+1 919 622-1501; kriseberlein (skype)