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: Issues with DITA v1.3 Errata 02 csprd01

OK, I've fixed all of the items that can be handled in the source.

The remaining items have to do with missing files and styling:

  • Missing ZIPs of CHM
  • Missing HTML for part 0
  • The phrase "Plus Errata 02" on in the title should be in red text

I'll see what I can get from the build. Bob, I might need you to build if I run into difficulties.


Kristen James Eberlein
Chair, OASIS DITA Technical Committee
Principal consultant, Eberlein Consulting
+1 919 622-1501; kriseberlein (skype)

On 2/6/2018 1:45 PM, Paul Knight wrote:
forwarding to TC mailing list - intended to include TC in initial message...
---------- Forwarded message ----------
From: Paul Knight <paul.knight@oasis-open.org>
Date: Tue, Feb 6, 2018 at 12:28 PM
Subject: Issues with DITA v1.3 Errata 02 csprd01
To: Kristen Eberlein <kris@eberleinconsulting.com>
Cc: Chet Ensign <chet.ensign@oasis-open.org>

Hi Kris and DITA TC members,

In getting the DITA material [1] ready to publish, we found some issues, including missing files ((5) and (7)), a bad link (6), and incorrect titles and subtitles (the other numbered items).

A list of what needs to be fixed is below. Most of these items were okay for Errata 01 [3], so that can be a model, along with the templates noted below. It appears that none of these items affect the technical content of the DITA material, so there is no need for a formal TC re-approval, and no need to modify the approval date (23 January 2018).  

1) The subtitles of the "Parts" (0, 1, 2, 3) are incorrect:
-- They say: Committee Specification Draft 01 / Public Review Draft >incorporating Public Review Draft 01 of Errata 02<
-- They SHOULD say: OASIS Standard >incorporating Public Review Draft 01 of Errata 02<

2) The "Citation format" blocks (of Parts 0, 1, 2, and 3) have the same error as in (1) - they SHOULD say: OASIS Standard incorporating Public Review Draft 01 of Errata 02.

3) The "Citation format" block of the Errata listing is missing the final "01" in the subtitle - it SHOULD say:
"Committee Specification Draft 01 / Public Review Draft 01."
(It should be the same as the subtitle at the top of page 1 of the Errata listing, which is correctly worded, although missing a space before the slash.)

Please see the examples provided in the template files delivered in December 2016, at https://lists.oasis-open.org/archives/dita/201612/msg00113.html.

4) In the main titles of the four "complete" parts (0, 1, 2, 3), the phrase "Plus Errata 02" should be in red text, as was done in Errata 01 (and in the template files)

5) (?) (may be okay now) In the "Additional artifacts" sections of Parts 1, 2, and 3, there are references to a "ZIP file that contains a CHM version", but these ZIP files (...-complete-chm.zip) were not provided in the ZIP package.

NEW NOTE for (5) - We just noted that the Jan. 23 minutes referred to the missing CHM files, to be prepared by Bob Thomas. It looks like Bob uploaded a file [2] with CHM material on Jan. 26. This contains five CHM files. (not zipped). In the material prepared by the TC, there are links for only three CHM.ZIP files - for parts 1,2, and 3. Also, previously in Errata 01, the CHM.ZIP files were only published for Parts 1, 2, and 3. So we can use Bob's material by zipping the CHM files for Parts 1, 2, and 3, and ignoring the other two CHM files (Part 0 and Errata listing). [However, it is possible that all the CHM files may need to be regenerated anyway, if the other changes noted here affect the CHM files]

6) In the "Additional artifacts" section of Part 3, the reference to a "ZIP file that contains an HTML version" ends in "...-complete-chm.zip", the same as the line above it. It should end in "...-complete-html.zip"

7) There is no HTML file provided for Part 0 (the file xhtml/dita-v1.3-errata02-csprd01-part0-overview-complete.zip is empty in the main ZIP package)

These are the only items we've noted.

Paul Knight  - Tel: +1 781-883-1783
OASIS - Advancing open standards for the information society - Document Process Analyst

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