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 1.2, CD 02 submission (DITA1.2-CD02.zip) uploaded

Hi Kris,

  answers inline.

On Jun 22, 2010, at 2:07 AM, Kristen James Eberlein wrote:

Hi, Mary.

Please see my comments or questions below in
<kje> tags.


BA930D6B-2C60-4803-BCDC-63151330EA4E@oasis-open.org" type="cite">

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
<kje>Help me understand, since I obviously misunderstood your earlier comments. Is it the case that the links in the "This version" section always point to a specific version -- cd01, cd02, cs -- but the links in the "Latest version" section always are the generic URIs? If so, is the following what you want in the "This version" section?"

http://docs.oasis-open.org/dita/v1.2/cd02/spec/DITA1.2-spec.html (Authoritative version)




BA930D6B-2C60-4803-BCDC-63151330EA4E@oasis-open.org" type="cite">

This was originally laid out in an email back on 18 May and yes, the 'this version' link always points to a version-specific URI and the 'latest version' link always points to a more generic URI that will always bring you to whatever the latest version is at the time (if you're looking at CD01 and the spec is now an OS, it would take you to the OS).

BA930D6B-2C60-4803-BCDC-63151330EA4E@oasis-open.org" type="cite">

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.

<kje>By "actual hypertext link," do you mean a link to what you call the "namespace document"? If so, where do you want to locate the "namespace document"? Give us a URL, and we will reference it. (
I am not sure why you mention the focus area.)

The nomenclature is problematic, since the actual "Declared XML namespace" is xmlns:ditaarch="http://dita.oasis-open.org/architecture/2005/"

Perhaps this section should be retitled "Location of OASIS namespace document"?

If we were to put an http namespace on the cover, it must not only appear in text, but also be hypertext-linked to the location. i.e. <a href="http://docs.oasis-open.org/ns/dita/ditanamespace">http://docs.oasis-open.org/ns/dita/ditanamespace</a>

BA930D6B-2C60-4803-BCDC-63151330EA4E@oasis-open.org" type="cite">

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

<kje>I'll open an action item to correct this aspect of the PDF formatting.</kje>
BA930D6B-2C60-4803-BCDC-63151330EA4E@oasis-open.org" type="cite">
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.
<kje>I am reluctant to have a lengthy list of appendices which would be at the same level as major content. For example, if I followed your suggestion, the TOC would look like this:

Architecture specification
Language reference
Appendix A
Appendix B
Appendix C
Appendix D
Appendix E
Appendix F
Appendix H
Appendix I
Appendix J

Instead, I'll reorg
anize the material as follows, which provides a better alignment with the OASIS specification template:

Architecture specification
Language reference

Non-normative information
Appendix A. Acknowledgments

? TOC typically includes several levels; not just the top level, and yes, each Appendix is the equivalent of a section and must be listed. No, TOC organization should not require a new vote.

Please let me know ASAP if you think such a reorganization will require a new TC vote.

BA930D6B-2C60-4803-BCDC-63151330EA4E@oasis-open.org" type="cite">

NOTE: In the top section level head, the rule should be the same purple as the headings themselves.
BA930D6B-2C60-4803-BCDC-63151330EA4E@oasis-open.org" type="cite">

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

<kje>Just to check, the base for the URL that you want here is http://docs.oasis-open.org/dita/v1.2/cd02/spec/DITA1.2-spec.html, correct?</kje>

yes, presuming that's what's noted as the 'this version' URI.

BA930D6B-2C60-4803-BCDC-63151330EA4E@oasis-open.org" type="cite">

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 --------
Subject: [dita] Groups - DITA 1.2, CD 02 submission (DITA1.2-CD02.zip) uploaded
Date: 21 Jun 2010 12:04:35 -0000
From: kris@eberleinconsulting.com
To: dita@lists.oasis-open.org

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

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