[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]
Subject: Re: [codelist] Code List TC URIs/URLs; was: Dissenting argument on namespace URI
OK, I've been thinking some more about document URLs for different versions of our documents. In the new OASIS template, there are 4 sets of document URLs. I'm putting in some suggestions, which I'll explain afterwards: ---- Specification URIs: This Version: http://docs.oasis-open.org/codelist/cd-genericode-1.0/doc/oasis-code-list-representation-genericode.html http://docs.oasis-open.org/codelist/cd-genericode-1.0/doc/oasis-code-list-representation-genericode.odt http://docs.oasis-open.org/codelist/cd-genericode-1.0/doc/oasis-code-list-representation-genericode.pdf Previous Version: Not applicable Latest Version: http://docs.oasis-open.org/codelist/genericode/latest/doc/oasis-code-list-representation-genericode.html http://docs.oasis-open.org/codelist/genericode/latest/doc/oasis-code-list-representation-genericode.odt http://docs.oasis-open.org/codelist/genericode/latest/doc/oasis-code-list-representation-genericode.pdf Latest Approved Version: Not applicable. ---- The "This Version" URLs are as we have agreed, although I've added the specific documents this time. I'm presuming we won't list "Previous Version" in this case, since there are no previous committe drafts, etc. For "Latest Version", I'm suggesting that we use a http://docs.oasis-open.org/codelist/genericode/latest/ area to provide canonical references to latest versions of documents (committee drafts, committee standards, and/or OASIS standards). For example: http://docs.oasis-open.org/codelist/genericode/latest/doc/oasis-code-list-representation-genericode.html http://docs.oasis-open.org/codelist/genericode/latest/doc/oasis-code-list-representation-genericode.odt http://docs.oasis-open.org/codelist/genericode/latest/doc/oasis-code-list-representation-genericode.pdf Similarly, I'm going to suggest (although not shown in this case) that we use a http://docs.oasis-open.org/codelist/genericode/approved/ area to provide canonical references to the latest committee standard or OASIS standard versions of documents. For example: http://docs.oasis-open.org/codelist/genericode/approved/doc/oasis-code-list-representation-genericode.html http://docs.oasis-open.org/codelist/genericode/approved/doc/oasis-code-list-representation-genericode.odt http://docs.oasis-open.org/codelist/genericode/approved/doc/oasis-code-list-representation-genericode.pdf However, if we were to go with this plan, then I think it would be more consistent to change our committe draft 1.0 URLs to http://docs.oasis-open.org/codelist/genericode/cd-1.0/doc/oasis-code-list-representation-genericode.html http://docs.oasis-open.org/codelist/genericode/cd-1.0/doc/oasis-code-list-representation-genericode.odt http://docs.oasis-open.org/codelist/genericode/cd-1.0/doc/oasis-code-list-representation-genericode.pdf which differs from UBL usage, but would make things like URL re-writing of canonical URIs more straightforwards. Does that sound plausible? This is just a suggestion, alternate proposals are very welcome. Cheers, Tony. On Tue, 17 Apr 2007 21:00:23 +0100, Anthony B. Coates (Miley Watts) <abcoates@mileywatts.com> wrote: > Thanks Ken, that's good. However, how should we provided URLs for > "latest" and "latest accepted" versions? Thanks, > > Cheers, Tony. > > On Tue, 17 Apr 2007 19:07:47 +0100, G. Ken Holman > <gkholman@CraneSoftwrights.com> wrote: > >> Thanks for bringing these questions to the fore, Tony ... it has made >> me realize that we have some decisions to make before finishing up the >> documentation. >> >> At 2007-04-17 17:50 +0100, Anthony B. Coates (Miley Watts) wrote: >>> On Tue, 17 Apr 2007 03:52:49 +0100, Robin Cover <robin@oasis-open.org> >>> wrote: >>> >>>> http://docs.oasis-open.org/codelist/ns/genericode/1.0/ NS URI >>>> http://docs.oasis-open.org/codelist/ns/genericode/ RDDLs >>>> http://docs.oasis-open.org/codelist/schemas/genericode/1.0/ Schemas >>> >>> I realise now (as I'm looking at the latest OASIS document templates) >>> that >>> we also need a URL location for the spec itself (and perhaps the >>> requirements doc too). I would like to suggest that the specification >>> should have a URL of the form >>> >>> http://docs.oasis-open.org/codelist/documentation/genericode/1.0/oasis-code-list-representation-genericode-1.0.* >> >> Again from my UBL experience led by Jon, I think it is very helpful in >> UBL that all of the files associated with a deliverable are found in >> subdirectories of a single subdirectory for that deliverable: >> >> http://docs.oasis-open.org/ubl/cs-UBL-2.0/ >> http://docs.oasis-open.org/ubl/os-UBL-2.0/ >> >> So in our case the directory structures would be: >> >> http://docs.oasis-open.org/codelist/ns/genericode/1.0/ NS URI >> http://docs.oasis-open.org/codelist/ns/genericode/ RDDLs >> http://docs.oasis-open.org/codelist/cd-genericode-1.0/ Draft >> http://docs.oasis-open.org/codelist/cd-genericode-1.0/xsd/ >> http://docs.oasis-open.org/codelist/cd-genericode-1.0/doc/ >> http://docs.oasis-open.org/codelist/cs-genericode-1.0/ Spec >> http://docs.oasis-open.org/codelist/cs-genericode-1.0/xsd/ >> http://docs.oasis-open.org/codelist/cs-genericode-1.0/doc/ >> http://docs.oasis-open.org/codelist/os-genericode-1.0/ Standard >> http://docs.oasis-open.org/codelist/os-genericode-1.0/xsd/ >> http://docs.oasis-open.org/codelist/os-genericode-1.0/doc/ >> >> We could include in the genericode doc subdirectory (and call out from >> an informative annex in the document) the code list examples you cite >> in your text available in the doc/ directory as standalone files (such >> that readers don't need to cut and paste to get real copies of the >> examples you have). >> >> This turns the directory structure inside out from what we discussed >> before today's teleconference: using the release as a base and having >> an expected set of subdirectories (thus keeping voting packages easily >> together in a ZIP distribution). >> >>> where the extension could be "odt" or "pdf" (and I could do "doc" if >>> required as well). >> >> Right ... there is no use of index.html ... that way looking at the >> base directory you will see the individual ODT and PDF (and HTML?) >> renderings of the specification. >> >> . . . . . . . . . . Ken >> >> >> -- >> World-wide corporate, govt. & user group XML, XSL and UBL training >> RSS feeds: publicly-available developer resources and training >> G. Ken Holman mailto:gkholman@CraneSoftwrights.com >> Crane Softwrights Ltd. http://www.CraneSoftwrights.com/o/ >> Box 266, Kars, Ontario CANADA K0A-2E0 +1(613)489-0999 (F:-0995) >> Male Cancer Awareness Aug'05 http://www.CraneSoftwrights.com/o/bc >> Legal business disclaimers: http://www.CraneSoftwrights.com/legal >> > > > -- Anthony B. Coates Senior Partner Miley Watts LLP Experts In Data +44 (79) 0543 9026 Data standards participant: genericode, ISO 20022 (ISO 15022 XML), UN/CEFACT, MDDL, FpML, UBL. http://www.mileywatts.com/
[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]