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

 


Help: OASIS Mailing Lists Help | MarkMail Help

legaldocml-comment message

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


Subject: Public review comments for Akoma Ntoso Version 1.0 Part 1: XML Vocabulary CSPRD01


Members of the LegalDocML TC,

In preparing your draft for publication, we noted the following items that you may wish to address. 

- In the table in section 6.2, Subdivision section, two of the cells under 'EU tradition' have footnote superscript numbers but no actual footnotes. In the PDF document, they do nothing. In the HTML, they jump the reader to the end of the document. You may want to remove the footnote markers.

- Please check the reference to [RFC2119] in section 1.1 in your document. I believe the link was broken, producing an "Error! Reference source not found." In publishing, we changed it to plain text. 

- 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. In particular, [AkomaNtosoNaming-v1.0] can simply be listed on the front page in the "Related work" section.

Also, for those that you do choose to keep, the normative references [ISO3166], [ISO639-2], and [XML-SCHEMA] don't have actual hyperlinks - just blue text of a link.

- The link to the namespace in section 4.1.1 is broken. The link itself is different than the visible text. The hyperlink is for "http://docs.oasis-open.org/legaldocml/ns/akn/3.0/CSD11" (should be CSD13).

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.org

Primary: +1 973-996-2298
Mobile: +1 201-341-1393 


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