Next in thread →
Next in month →
RE: [dita] Groups - DITA 1.2 spec: CD 01, namespace document (DITA1.2-namespace.html) uploaded
During today's TC call, I took the action to outline what I think we should do to our namespace document, the latest version of which is at http://www.oasis-open.org/committees/download.php/38287/DITA1.2-namespace.html See below. > -----Original Message----- > From: [mailto:] > Sent: Tuesday, 2010 June 15 9:30 > To: > Subject: [dita] Groups - DITA 1.2 spec: CD 01, namespace document > (DITA1.2-namespace.html) uploaded > > The document revision named DITA 1.2 spec: CD 01, namespace document > (DITA1.2-namespace.html) has been submitted by Kristen Eberlein to the > OASIS Darwin Information Typing Architecture (DITA) TC document > repository. > This document is revision #1 of DITA1.2-namespace.html. > > Document Description: > > > View Document Details: > http://www.oasis-open.org/committees/document.php?document_id=38287 > > Download Document: > http://www.oasis-open.org/committees/download.php/38287/DITA1.2-namespace.html > > Revision: > This document is revision #1 of DITA1.2-namespace.html. The document > details page referenced above will show the complete revision history. Most of my problems are due to questions I have with the OASIS namespace document template which is at http://docs.oasis-open.org/templates/namespace.html In the template, the first text is supposed to be [Namespace Title]. It is not clear to me what that means, but I notice that the Introduction sentence is supposed to include the "namespace title and...", and I wonder if that is supposed to be the same [Namespace Title]. The first sentence of the Versioning Policy section talks about "the [namespace title] namespace URI", and in the Related Resources section of the template, it refers to the [namespace title]. Mary, please explain what each of [Namespace Title], "namespace title...", "[namespace title] namespace URI", and [namespace title] are supposed to be. Given the mention of "[namespace title] namespace URI", and in the absence of any information from Mary to the contrary, I will assume that all four references are meant to refer the the namespace name (which is the correct term for the "namespace URI"). Attached to this message is what I suggest our namespace document should look like. When approved, this document needs to be placed at http://dita.oasis-open.org/architecture/2005/index.html Here are some notes about what I did to get this document: 1. I put the namespace name everywhere the template had some version of a reference to "namespace title". 2. I changed "namespace URI" to "namespace name". 3. I made sure the namespace name in the intro linked to the correct location. 4. I changed irrelevant WSDL references to DTDs and deleted the bullet point about WSDL. I also reworded slightly to avoid "non-backwardly". paul
Next in thread →
Next in month →