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


Help: OASIS Mailing Lists Help | MarkMail Help

xliff-comment message

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

Subject: improve the appearance of schema files

Some suggestions for improving the appearance of the schema files:


·         When a schema attribute is optional and the default value applies, sometimes it's expressed and sometimes it’s omitted. We should choose one approach, and be consistent.

·         Add a descriptive comment to each element definition (as already exist for inline elements). The comment can be taken directly from the documentation, for most elements.

·         Add organizing comments throughout; e.g. imports, attribute types, elements.

·         Apply consistent formatting (indentation, blank lines, etc.).

·         Apply a logical order to elements in choice groups (may be alphabetical or hierarchy order).

·         Apply a logical order for XLIFF attributes: required (alphabetical) before optional (alphabetical), #any last.


None of these affect the syntax or semantics, but they will be useful for implementers who read the schema files.



Tom Comerford

+1 856 787 9090


Supratext LLC
43 Michaelson Drive
Mount Laurel, NJ 08054




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