RE: [dita] Order for elements in the base language reference

["Ogden, Jeff" <jogden@ptc.com>]

I like the overall organization.

I have reservations about the heading "Metadata elements" because that
may imply that indexing and delayed conref resolution elements are
included when we use the word "metadata" or the phrase "metadata
elements" elsewhere in the specification.  If all of those elements can
always be considered "metadata elements" and the rules for processing
metadata elements apply to them all, then my reservation is withdrawn.
Or if some elements in the category aren't considered "metadata
elements" for the purposes of processing, an alternative is to find all
occurrences of the term "metadata" and the phrase "metadata elements"
and make sure that exactly which elements are included is defined
somewhere nearby.  In fact this later approach is probably a good idea
anyway.

Where in the list of topic elements will the "dita" element appear?  As
long as it isn't at the top or very near the top, I'm OK with its
placement as a topic element.  The description just needs to make it
clear that "dita" isn't a topic element like other topic elements, it is
a super topic element and it cannot be specialized.
  
   -Jeff

> -----Original Message-----
> From: Kristen James Eberlein [mailto:keberlein@pobox.com]
> Sent: Tuesday, September 29, 2009 10:43 AM
> To: DITA TC
> Subject: [dita] Order for elements in the base language reference
> 
> Su-Laine and I have come to agreement on how to group the elements in
> the base Language Reference. Here's an outline of the TOC:
> 
> Topic elements
> -----Basic topic elements
> -----Body elements
> -----Table elements
> -----Related links elements
> Map elements
> -----Basic map elements
> -----Map group elements
> Metadata elements
> -----Prolog (metadata) elements
> -----Indexing group elements
> -----Delayed conref resolution elements
> Domain elements
> -----Hazard-statement domain elements
> -----Typographic domain elements
> -----Utilities domain elements
> Classification elements
> -----Subject scheme maps
> -----Classification domain elements
> Specialization elements
> DITAVAL elements
> Legacy conversion elements
> 
> This grouping eliminates the DITA 1.1 grouping of "Miscellaneous
> elements." Here is where the various elements grouped under that
> heading
> have been moved to:
> 
> dita --> Basic topic elements
> draft-comment --> Body elements
> fn--> Body elements
> indexterm --> Indexing group elements
> indextermref --> Indexing group elements
> index-base --> Specialization elements
> tm--> Body elements
> data --> Specialization elements
> data-about --> Specialization elements
> foreign --> Specialization elements
> unknown --> Specialization elements
> 
> Kris
> 
> 1.0 Miscellaneous elements
> <http://docs.oasis-open.org/dita/v1.1/CD01/langspec/common/valid.html>
> 
>     11.01 dita
> <http://docs.oasis-open.org/dita/v1.1/CD01/langspec/langref/dita.html>
> 
>     11.02 draft-comment
> <http://docs.oasis-open.org/dita/v1.1/CD01/langspec/langref/draft-
> comment.html>
> 
>     11.03 fn
> <http://docs.oasis-open.org/dita/v1.1/CD01/langspec/langref/fn.html>
> 
>     11.04 indexterm
> <http://docs.oasis-
> open.org/dita/v1.1/CD01/langspec/langref/indexterm.html>
> 
>     11.05 indextermref
> <http://docs.oasis-
> open.org/dita/v1.1/CD01/langspec/langref/indextermref.html>
> 
>     11.06 index-base
> <http://docs.oasis-open.org/dita/v1.1/CD01/langspec/langref/index-
> base.html>
> 
>     11.07 tm
> <http://docs.oasis-open.org/dita/v1.1/CD01/langspec/langref/tm.html>
> 
>     11.08 data-about
> <http://docs.oasis-open.org/dita/v1.1/CD01/langspec/langref/data-
> about.html>
> 
>     11.09 data
> <http://docs.oasis-open.org/dita/v1.1/CD01/langspec/langref/data.html>
> 
>     11.10 foreign
> <http://docs.oasis-
> open.org/dita/v1.1/CD01/langspec/langref/foreign.html>
> 
>     11.11 unknown
> <http://docs.oasis-
> open.org/dita/v1.1/CD01/langspec/langref/unknown.html>
> 
> 
> 
> 
> ---------------------------------------------------------------------
> 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