Re: [dita] Problems with DITA v1.2 submission

[Kristen James Eberlein <kris@eberleinconsulting.com>]

Hi, Mary.

Thanks for reviewing our submission and catching the items that we need to correct. I'm glad that you like the new topic about "Formatting conventions in the XHTML version of the specification."

I've uploaded a new ZIP; you can download it from http://www.oasis-open.org/apps/org/workgroup/dita/download.php/38318/DITA1.2-CD02.zip . It addresses all of the items except for the following:

• (PDF) Footer needs to specify DITA 1.2 CD 02
• (PDF) Each appendix should start on a new page; each appendix heading should be styled as a level 1 heading.
• (PDF) Formatting of content of <example> elements is incorrect:
• Remove purple rule in heading; style heading similar to other headings of that level
• Text in <example> element should be black, not purple.
  

Can you look over the XHTML, CHM, and DITA source? If it is now correct, we'll turn our attention to implementing the changes in the PDF.

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/17/2010 12:26 AM, Mary McRae wrote:

B7F3C34C-14EE-4282-A58C-465D485462CB@oasis-open.org" type="cite">

Hi Kris,

  It looks like some stuff didn't get updated to cd02.

In the PDF version:

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

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

3. Namespace: this must be an actual hypertext link

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

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.

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


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.

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

3. The link back to the main page points to cd01


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.


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

1. Same footer problem as XHTML


I don't think any of these problems require anything other than updates to the front matter URI hypertext links and reprocessing so no additional ballots are required on the part of the TC; just a new distribution set.

You don't need to do a new submission; just send an email with a link to the new zip.

Thanks!

Mary

Mary P McRae
Director, Standards Development
Technical Committee Administrator
OASIS: Advancing open standards for the information society
email: mary.mcrae@oasis-open.org 
web: www.oasis-open.org
twitter: @fiberartisan  #oasisopen
phone: 1.603.232.9090

Standards are like parachutes: they work best when they're open.




---------------------------------------------------------------------
To unsubscribe from this mail list, you must leave the OASIS TC that
generates this mail.  Follow this link to all your TCs in OASIS at:
https://www.oasis-open.org/apps/org/workgroup/portal/my_workgroups.php