Re: [codelist] Code List TC URIs/URLs; was: Dissenting argument on namespace URI

["Anthony B. Coates (Miley Watts)" <abcoates@mileywatts.com>]

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: ISO 20022 (ISO 15022 XML), ISO 19312,  
UN/CEFACT TMG, MDDL, FpML, UBL.
http://www.mileywatts.com/