| Hi Kris,
answers inline.
On Jun 22, 2010, at 2:07 AM, Kristen James Eberlein wrote:
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
<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"?</kje>
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 2.1.2.2.5
<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:
Introduction
Architecture specification
Language reference
Conformance
Appendix A
Appendix B
Appendix C
Appendix
D
Appendix E
Appendix F
Appendix
H
Appendix I
Appendix J
Instead, I'll reorganize the material as follows, which provides a better
alignment with the OASIS specification template:
Introduction
Architecture specification
Language reference
Non-normative information
Conformance
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.
</kje>
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
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:
http://www.oasis-open.org/apps/org/workgroup/dita/download.php/38368/DITA1.2-CD02.zip
All the changes that you requested have been completed.
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)
-------- Original Message --------
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:
http://www.oasis-open.org/committees/document.php?document_id=38368
Download Document:
http://www.oasis-open.org/committees/download.php/38368/DITA1.2-CD02.zip
Revision:
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
|