[Fwd: New ODF errata document - page & line numbers]

[Francis Cave]

General practice in the preparation of ISO/IEC Corrigenda seems to be to
reference by clause and paragraph number only. I have tended to do the same
in preparing defect reports.

In preparing a text for DCOR ballot it is helpful to include a reference to
the defect report, so that readers of the DCOR text are made aware of the
background to making the correction - this has been done recently, for
example, in the DCOR ballots on IS 29500. I see no reason why the JIRA issue
should not be referenced where appropriate. All such references (whether to
defect reports or JIRA issues) would be removed from the final text prior to
publication.

Francis Cave
Convenor, WG 6



> -----Original Message-----
> From: sc34wg6-bounces at vse.cz [mailto:sc34wg6-bounces at vse.cz] On Behalf
> Of robert_weir at us.ibm.com
> Sent: 09 January 2010 16:14
> To: sc34wg6 at vse.cz
> Subject: Re: [Fwd: New ODF errata document - page & line numbers]
> 
> Hi Svante,  From the OASIS perspective, the only requirement is that
> errata consist of a "set of proposed corrections...in the form of a
> list
> of changes".
> 
> So anything that clearly and unambiguously indicates what the change is
> should be fine.
> 
> IMHO, line numbers are problematic when dealing when you have changes
> to
> tables or images, since indicating a line number is not always easy
> there.
> 
> But if you reference merely the clause number, makes sure that you give
> enough context to make it unambiguous.  So if you say "insert 'foo'
> before
> 'bar' in section 1.2.3", then be sure that 'foo' occurs only once in
> that
> section.
> 
> -Rob
> 
> 
> sc34wg6-bounces at vse.cz wrote on 01/08/2010 06:38:31 PM:
> 
> > Subject: New ODF errata document - page & line numbers
> > Date: Fri, 08 Jan 2010 16:47:17 +0100
> > From: Svante Schubert <Svante.Schubert at Sun.COM>
> > To: sc34wg6-request at vse.cz
> >
> > Hi,
> >
> > I took over the role as an editor of the next ODF errata document and
> > would like to ask in my role of a WG6 participant if there is an
> urgent
> > need for page & line numbers in the OASIS errata document as an
> > additional reference aside of the section and paragraph reference.
> >
> > The problems with page & line numbers are:
> >
> >   1. There are two page & line numbers one for the OASIS and one for
> >      the ISO document
> >   2. Confusion occurred in the past if physical or written page
> number
> >      was meant
> >   3. It is a redundant reference, which causes annoying side work and
> >      bring no additional benefit to the user
> >
> > If there is no protest, I would stick on the section/paragraph
> > references solely, but in contrary to the previous errata would add a
> > reference to the JIRA issue.
> >
> > Best regards,
> > Svante
> 
> _______________________________________________
> sc34wg6 mailing list
> sc34wg6 at vse.cz
> http://mailman.vse.cz/mailman/listinfo/sc34wg6