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

 


Help: OASIS Mailing Lists Help | MarkMail Help

dita message

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


Subject: Re: Scope and applicability of the "OASIS Naming Guidelines"






On Jun 24, 2010, at 8:50 AM, Kristen James Eberlein wrote:

On a different note, "The OASIS Naming Guidelines Part 1: Filenames, URIs, Namespaces" contains the following text:

"No retroactive application of rules is envisioned for resources already accessible via the OASIS Open Library; URIs and resources as currently exist will be grandfathered."
There are no current URIs or resources on the OASIS library related to the declared namespace. It was a complete unknown until I raised the issue earlier this month so there is nothing to grandfather.

The quoted sentence is from the "Scope and Applicability" section:
http://docs.oasis-open.org/specGuidelines/namingGuidelines/resourceNaming.html#scope

I read this to mean that since the existing DITA namespace was part of the DITA 1.0 and DITA 1.1 standard, it should be grandfathered.

Robin Cover is listed as the editor of these guidelines, which were approved by the OASIS Board on 2008-10-09, with a minor update on 2009-08-01. I'm going to cc him on this e-mail so that he can be included in the discussion.


Best,

Kris

Kristen James Eberlein
Principal consultant, Eberlein Consulting
Secretary, OASIS DITA Technical Committee
Charter member, OASIS DITA Adoption Committee

www.eberleinconsulting.com
+1 919 682-2290; kriseberlein (skype)

On 6/23/2010 2:36 PM, Eliot Kimber wrote:
E1DA857A-385D-4659-9A9F-CA5FFE73C60F@oasis-open.org" type="cite">
The namespace cannot be changed because of backward compatibility
requirements in DITA 1.x.

That is, if the namespace were changed, all existing DITA documents and
document types would be broken.

Not to mention software that uses the namespace name in some way (such as to
recognize DITA documents, which is it's purpose).

Cheers,

Eliot


On 6/23/10 7:26 AM, "Kristen James Eberlein" <kris@eberleinconsulting.com>
wrote:

  
Hi, Mary and others.

The namespace http://dita.oasis-open.org/architecture/2005/ is officially part
of the OASIS DITA 1.0 and OASIS DITA 1.1 specifications. See the following
topics in the specifications:
* http://docs.oasis-open.org/dita/v1.1/OS/langspec/langref/topic.html
* http://docs.oasis-open.org/dita/v1.0/langspec/topic.html
Can someone clearly and thoroughly explain just what the ramifications would
be if we were to change this to align with OASIS's namespace policies?

Best,

Kris

Kristen James Eberlein
Principal consultant, Eberlein Consulting
Secretary, OASIS DITA Technical Committee
Charter member, OASIS DITA Adoption Committee
www.eberleinconsulting.com <http://www.eberleinconsulting.com/>
+1 919 682-2290; kriseberlein (skype)

On 6/23/2010 7:56 AM, Mary McRae wrote:
    
The namespace http://dita.oasis-open.org/architecture/2005/ is not allowed.
We 
do use a redirect of sorts to deliver the namespace document at the namespace
location, but dita.oasis-open.org <http://dita.oasis-open.org>  is not
allowed. 

 
 
Regards,
 

 
 
Mary 
 

 
 
 
 
 
On Jun 23, 2010, at 3:45 AM, Don Day wrote:
 
 
      
 
Is it possible to set a redirect for the location
http://dita.oasis-open.org/architecture/2005/ that simply goes to the
preferred OASIS hosting address? That would seem to be the easiest way
forward and avoids the current case of a 404 return message, which fits my
definition of "the principle of astonishment" that standards usually try to
avoid!  ;-)
 
--
Don Day
 
Grosso, Paul wrote:
        
  
 

Mary,
 
 
 
We aren't communicating.
 
 
 
I don't know what "it" isn't the issue for you.
 
 
 
I don't know what it means for a namespace to be at a location.
 
 
 
The DITA namespace name is http://dita.oasis-open.org/architecture/2005/.
That is unchangeable.
 
 
 
When someone puts a namespace name into a browser, they are supposed to be
served a namespace document.  That is a recommendation of the W3C Technical
Advisory Group headed by Tim Berners-Lee.  I don't not want to see OASIS
violate this, and I would hope you and the other people who make OASIS
policy [isn't that supposed to be the OASIS members, i.e., us] would not
want to violate this either.
 
 
 
So something needs to be served when
http://dita.oasis-open.org/architecture/2005/ is accessed. The easiest way
to do that is to put something at
http://dita.oasis-open.org/architecture/2005/index.htm. That something can
either be the namespace document or a document that redirects to a copy of
the namespace document.
 
 
 
paul
 
 
 
 
 
 

From: Mary McRae [mailto:mary.mcrae@oasis-open.org]
 Sent: Tuesday, 2010 June 22 21:28
 To: Grosso, Paul
 Cc: Kristen James Eberlein; DITA TC
 Subject: Re: [dita] Re: DITA 1.2, CD 02 submission (DITA1.2-CD02.zip)
uploaded
 
 
 
 
 
Hi Paul,
 
 

 
 
 
 

  No, that's not the issue. OASIS requires all namespaces to live at
http://docs.oasis-open.org/ns/dita/... or
http://docs.oasis-open.org/dita/ns. If a namespace was declared prior to
the 
naming guidelines going into effect (which created the explicit 'ns' in the
path) then it must be at http://docs.oasis-open.org/dita/...  It can't be
at 
dita.oasis-open.org <http://dita.oasis-open.org/> .
 
 
 

 
 
 
 
 
 
 
 
 
 
 
 
 

Mary 
 
 
 
 
 
 
 
 
 
 
 

 
 
 
 
 
 
 
 

On Jun 21, 2010, at 11:49 PM, Grosso, Paul wrote:
 
 

 
 
 
 
 

Re:
 
 
 

 
 
 
 

The namespace must live on http://docs.oasis-open.org/dita - it cannot live
at the site of the focus area.
 
 
 

 
 
 
 

I assume by "namespace" you mean the namespace document.
 
 
 

 
 
 
 

The namespace name is http://dita.oasis-open.org/architecture/2005/
 
 
 

 
 
 
 

Since the namespace document has to be returned when one accesses the
namespace name, the namespace document (or perhaps a redirect to it) has to
reside at http://dita.oasis-open.org/architecture/2005/index.htm.
 
 
 

 
 
 
 

paul
 
 
 

 
 
 
 

 
 
 
 
 
 
 
 
 
          
 
 
        
 
 
      
    
  






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