This is an archived snapshot of W3C's public bugzilla bug tracker, decommissioned in April 2019. Please see the home page for more details.

Bug 2305 - stable fragment ids in specifications (editorial)
Summary: stable fragment ids in specifications (editorial)
Status: CLOSED FIXED
Alias: None
Product: XPath / XQuery / XSLT
Classification: Unclassified
Component: XQuery 1.0 (show other bugs)
Version: Last Call drafts
Hardware: PC Windows XP
: P2 normal
Target Milestone: ---
Assignee: Don Chamberlin
QA Contact: Mailing list for public feedback on specs from XSL and XML Query WGs
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2005-09-26 12:41 UTC by David Carlisle
Modified: 2005-09-28 14:02 UTC (History)
0 users

See Also:


Attachments

Description David Carlisle 2005-09-26 12:41:51 UTC
I'm raising this issue on XQuery, but it probably relates to all documents, as
they use the same build process, I think.
Most sections use a stable fragment identifier but some use one that looks like
the result of XSLT generate-id()

For example appendix H (Glossary) may be referenced as
http://www.w3.org/TR/xquery/#id-glossary
but appendix I (Example applications) may be referenced (today) as
http://www.w3.org/TR/xquery/#N1815A


Apart from not looking so nice, if these IDs are automatically generated it
means that they are _not_ stable and so the above URI reference will _break_
at the next draft as the copy in the undated URI is updated "in place".

there are several other examples, as easily seen by hovering over the table of
contents and watching the status line.

Presumably this could easily be fixed by giving the sections ids in the xmlspec
source or (as I did in MathML) modifying the stylesheets to use a more stable
generated id (for example based on the sction number).

David
Comment 1 Michael Kay 2005-09-26 13:41:00 UTC
I think it would be a good idea to change the DTD to make the id attribute
mandatory in the source, to prevent slip-ups.
Comment 2 Don Chamberlin 2005-09-28 14:02:34 UTC
David,
Thank you for this comment. On Sept. 28, 2005, the Query Working Group agreed 
with your suggestion. In future versions of XQuery specifications, all headings 
will have stable ID's. Since you labeled your comment as editorial and it was 
accepted by the working group, I have marked your comment as "Closed." Please 
feel free to reopen the comment if you have any further concerns or suggestions.
Regards,
Don Chamberlin