Re: [office] Groups -OpenDocument-v1.2-part0-draft1-editor-revision.odt uploaded

[Michael Brauer - Sun Germany - ham02 - Hamburg <Michael.Brauer@Sun.COM>]

Hi Dennis,

On 05/15/10 21:50, Dennis E. Hamilton wrote:
> I noticed the following about the part0-draft1 edition.
> 
> 1. Conformance Section - the use of the letter "I" in making conformance clauses in Part 0 is a little confusing.  It would be better to use some less-ambiguous capital letter.  Perhaps "C" which has not been used.

"C" is actually used in part 1, for "Consumers". I therefor have chosen 
"I" as in "Introduction". But it is indeed an arbitrary choice. Which on 
the one hand means that I have no objections to using any other letter 
here, but also think that the question which letter we use does not 
really matter. So I think it is not worth to discuss this in length.


> 
> 2. The page numbers for the section locations in Parts 1-3 don't work.  
> For example, Part 0 indicates that Part 1 section 22.4 is at p.916.  My copy of Part 1 cd4-rev05 has section 22.4 on p.824 of 844.  The PDF that I obtained by Export to PDF in OO.o 3.2.0 has section 22.4 at p.819 of 839.  For cross-referencing into an HTML this may be even less helpful.

Good catch. Seems I have copied the table of content from the editorial 
versions rather than from the non-editorial versions.

The table of contents in part 0 will be updated when we have created the 
approved committee draft documents. They should be in sync when.

> 
> 3. The use of active links in the enclosed Tables of Content is interesting.  If I have the *.odt files in the same directory together, I can follow links from Part 0 TOCs to the appropriate places in another part.  (This does not work with the Exported PDFs for some reason.)  There may need to be some non-normative information to that effect somewhere in Part 0.

I have added the relative paths to other parts of the documents just to 
show that this works in ODF documents. We need to adapt this paths when 
the approved documents have been copied to docs.oasis-open.org and when 
we know where they are located there.

Getting the links running for documents that are only located in our 
document repository and which may still updated is a little bit difficult.

Regarding PDF: It is my understanding that PDF document can't link to 
other PDF documents.

> 
> 4. Cross References.  I think it would be more helpful if the parts were listed in the normative references of other parts, so that they could be referenced in the usual way.  E.g., use "§2.7 in [ODF-Package]" rather than "§2.7 in Part 3."  This would allow the normative reference to be specific and detailed.  Whether the "§2.7" part could be an inter-document cross-reference is a separate but interesting question.

That's an interesting question. We consider the ODF specification to be 
  one standard, and the normative reference from other specifications is 
the one to the new part 0. Given that, I doubt that we could add a 
normative reference to a part of the standard we define.

> 
> 5. Appendices in the TOC.  I just don't understand why there are not links in the TOC to the sections of Appendices, just as there are links to other sections.  This is apparently a systematic exclusion and whatever its formal justification, it is a serious pain for users of these documents.  I don't understand what is so compelling about excluding navigatable links into Appendix material compared to the convenience that links offer to all users.

The links in the TOC to appendixes can't be generated automatically. I 
don't consider it to be a serious flaw that they do not work, but if a 
majority of TC members thinks that the issue is as severe that we should 
add the links manually in the approved documents, we could certainly do so.

Best regards

Michael
> 
>  - Dennis
> 
> -----Original Message-----
> From: michael.brauer@sun.com [mailto:michael.brauer@sun.com] 
> Sent: Friday, May 14, 2010 05:40
> To: office@lists.oasis-open.org
> Subject: [office] Groups - OpenDocument-v1.2-part0-draft1-editor-revision.odt uploaded
> 
> The document named OpenDocument-v1.2-part0-draft1-editor-revision.odt has
> been submitted by Michael Brauer to the OASIS Open Document Format for
> Office Applications (OpenDocument) TC document repository.
> 
> Document Description:
> OpenDocument v1.2 Overview (editor version)
> 
> View Document Details:
> http://www.oasis-open.org/committees/document.php?document_id=37809
> 
> Download Document:  
> http://www.oasis-open.org/committees/download.php/37809/OpenDocument-v1.2-part0-draft1-editor-revision.odt
> 
> 
> PLEASE NOTE:  If the above links do not work for you, your email application
> may be breaking the link into two pieces.  You may be able to copy and paste
> the entire link address into the address field of your web browser.
> 
> -OASIS Open Administration
> 


-- 
Michael Brauer, Technical Architect Software Engineering
StarOffice/OpenOffice.org
Sun Microsystems GmbH             Nagelsweg 55
D-20097 Hamburg, Germany          michael.brauer@sun.com
http://sun.com/staroffice         +49 40 23646 500
http://blogs.sun.com/GullFOSS

Sitz der Gesellschaft: Sun Microsystems GmbH, Sonnenallee 1,
	   D-85551 Kirchheim-Heimstetten
Amtsgericht Muenchen: HRB 161028
Geschaeftsfuehrer: Jürgen Kunz