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

[Francis Cave]

Regarding defect report identification, I quote from the current JTC 1
Directives (5th edition, but I don't think this will be affected by the
revision of the Directives), Clause 15.4.6:

"15.4.6 Defect Reports - Distribution

Upon receipt of a defect report, the WG Convener or Secretariat shall
complete part 1 of the form. The defect report number contained in part 1
consists of the IS or DIS number followed by a solidus and a sequentially
assigned number (e.g. 8326/006). The WG Convener or Secretariat shall attach
a WG document cover sheet which carries an assigned WG document number and
indicates the status of the report (e.g. "This defect report is forwarded to
the 8326 editor's group for review and response; it is sent to WG 6 for
information")."

I suspect that this rule on the identification of defect reports is more
honoured in the breach than otherwise. The numbering of defect reports for
IS 29500 has been handled rather differently, excluding the IS number but
including a two-digit year (e.g. DR-10-0001). I think in practice any
reasonable, systematic identification is acceptable. 

I'm happy to receive suggestions as to how best to handle defect report
numbering, and whether to apply retrospectively whatever approach we adopt.
Otherwise, I am sure that Kimura-san and I can agree a suitable system.

Francis




> -----Original Message-----
> From: sc34wg6-bounces at vse.cz [mailto:sc34wg6-bounces at vse.cz] On Behalf
> Of Francis Cave
> Sent: 09 January 2010 17:01
> To: sc34wg6 at vse.cz
> Subject: RE: [Fwd: New ODF errata document - page & line numbers]
> 
> 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
> 
> _______________________________________________
> sc34wg6 mailing list
> sc34wg6 at vse.cz
> http://mailman.vse.cz/mailman/listinfo/sc34wg6