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

[robert_weir at us.ibm.com]

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