Members of the LegalDocML TC,
In preparing your draft for publication, we noted the following items that you may wish to address.
- We noted that the items listed in Normative and Non-Normative references (e.g. [ISO3166]) are never referenced in the document itself. Typically the only reason to have the references collected in your document is because they are referred to from your document. If your spec doesn't actually refer readers to, for example, "International Resource Identifiers as per RFC 3987" then there seems to be no need to list them.
- Also, the normative references [ISO3166] and [ISO639-2] don't have actual hyperlinks - just blue text of a link.
- The last sentence in Section 4.4 contains two instances of "Error! Reference source not found." These are also present in the TC's initial submission. This typically happens when the link targets are changed in some way that breaks the link. You often don't see it in the text until you update the fields, for example, by regenerating the Table of Contents or saving as PDF.
- In section 4.7.2, a "mailto:" hyperlink has been generated (incorrectly) for the first item "/akn/us/act/123/en@2014-05-15~sect_13.xml". This has also occurred several times in section 4.10.10.
Please let us know if you have any questions on these.
--
/chet
----------------
Chet Ensign
Director of Standards Development and TC Administration
OASIS: Advancing open standards for the information society
http://www.oasis-open.orgPrimary: +1 973-996-2298
Mobile: +1 201-341-1393