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: [dita] Re: DITA 1.2, CD 02 submission (DITA1.2-CD02.zip) uploaded

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 is not allowed.



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:
9B2DE9094C827E44988F5ADAA6A2C5DA33A42E@HQ-MAIL9.ptcnet.ptc.com" type="cite">



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.




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.




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



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.



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.





From: Mary McRae [mailto:mary.mcrae@oasis-open.org] 
Sent: Monday, 2010 June 21 23:37
To: Kristen James Eberlein
Subject: [dita] Re: DITA 1.2, CD 02 submission (DITA1.2-CD02.zip) uploaded


Hi Kris,


  from the original list:


In the PDF version:

1. This Version URIs: text on the cover is fine, but the actual hypertext links point to cd01

> The URI has been incorrectly changed to point to the generic version rather than cd02; the URI was fine before - it was the hypertext link that was incorrect

2. Latest Version URIs: these are generic URIs that will be used to always access the most recent version of the spec. If you remove the cd02 subdir from the path it will be fine. Again, make sure the actual hypertext links are updated as well; they still point to cd01

> fixed

3. Namespace: this must be an actual hypertext link

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

4. running footer: please add CD 02 to DITA v1.2

> fixed

COMMENT: Section 1.4 is great! Thank you for adding this.

5. There are some rules showing up that seem to be tied to examples and should be removed; they appear to be tied to the heading below them.

> rules still appearing; see pg 33 - just prior to

6. Each Appendix should start a new page; same styling as 1st level headings

> The section labeled 'appendices' should be removed or turned into Appendix A.


NOTE: In the top section level head, the rule should be the same purple as the headings themselves.

In the XHTML version:
(in addition to the problems above)

1. The first page doesn't have any navigation links on the bottom. Should at least have next.

> fixed; but now all point to generic URI rather than version-specific. must point to version-specific.

2. The footer on each of the HTML pages says CD 01
> fixed

3. The link back to the main page points to cd01
> this now incorrectly points to the generic URI rather than cd02-specific


In the DITA source version:
(assume the same problems with hypertext links, URIs as in PDF)
1. the main html spec file is in this directory; not sure why it's duplicated.
> fixed

In the CHM version:
(same link and URI problems as in PDF)

1. Same footer problem as XHTML
> assuming it's fixed; haven't opened up windows.




On Jun 21, 2010, at 8:39 AM, Kristen James Eberlein wrote:

Mary, you can get the latest ZIP file from the following URL:

All the changes that you requested have been completed.



Kristen James Eberlein
Principal consultant, Eberlein Consulting
Secretary, OASIS DITA Technical Committee
Charter member, OASIS DITA Adoption Committee
+1 919 682-2290; kriseberlein (skype)

-------- Original Message --------


[dita] Groups - DITA 1.2, CD 02 submission (DITA1.2-CD02.zip) uploaded


21 Jun 2010 12:04:35 -0000




Thanks to Seth Park for his work on the weekend:
Changes to PDF:
* Modified footer
* Modified styling of <example>
* Appendices each start on new page
 -- Kristen Eberlein
The document revision named DITA 1.2, CD 02 submission (DITA1.2-CD02.zip)
has been submitted by Kristen Eberlein to the OASIS Darwin Information
Typing Architecture (DITA) TC document repository.  This document is
revision #3 of DITA1.2-CD01-submission.zip.
Document Description:
View Document Details:
Download Document:  
This document is revision #3 of DITA1.2-CD01-submission.zip.  The document
details page referenced above will show the complete revision history.
PLEASE NOTE:  If the above links do not work for you, your email application
may be breaking the link into two pieces.  You may be able to copy and paste
the entire link address into the address field of your web browser.
-OASIS Open Administration



"Where is the wisdom we have lost in knowledge?
Where is the knowledge we have lost in information?"
--T.S. Eliot

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