<?xml version="1.0" encoding="UTF-8" standalone="yes" ?>
<!DOCTYPE bugzilla SYSTEM "https://www.w3.org/Bugs/Public/page.cgi?id=bugzilla.dtd">

<bugzilla version="5.0.4"
          urlbase="https://www.w3.org/Bugs/Public/"
          
          maintainer="sysbot+bugzilla@w3.org"
>

    <bug>
          <bug_id>2305</bug_id>
          
          <creation_ts>2005-09-26 12:41:51 +0000</creation_ts>
          <short_desc>stable fragment ids in specifications (editorial)</short_desc>
          <delta_ts>2005-09-28 14:02:49 +0000</delta_ts>
          <reporter_accessible>1</reporter_accessible>
          <cclist_accessible>1</cclist_accessible>
          <classification_id>1</classification_id>
          <classification>Unclassified</classification>
          <product>XPath / XQuery / XSLT</product>
          <component>XQuery 1.0</component>
          <version>Last Call drafts</version>
          <rep_platform>PC</rep_platform>
          <op_sys>Windows XP</op_sys>
          <bug_status>CLOSED</bug_status>
          <resolution>FIXED</resolution>
          
          
          <bug_file_loc></bug_file_loc>
          <status_whiteboard></status_whiteboard>
          <keywords></keywords>
          <priority>P2</priority>
          <bug_severity>normal</bug_severity>
          <target_milestone>---</target_milestone>
          
          
          <everconfirmed>1</everconfirmed>
          <reporter name="David Carlisle">davidc</reporter>
          <assigned_to name="Don Chamberlin">chamberl</assigned_to>
          
          
          <qa_contact name="Mailing list for public feedback on specs from XSL and XML Query WGs">public-qt-comments</qa_contact>

      

      

      

          <comment_sort_order>oldest_to_newest</comment_sort_order>  
          <long_desc isprivate="0" >
    <commentid>6454</commentid>
    <comment_count>0</comment_count>
    <who name="David Carlisle">davidc</who>
    <bug_when>2005-09-26 12:41:51 +0000</bug_when>
    <thetext>I&apos;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 &quot;in place&quot;.

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</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>6455</commentid>
    <comment_count>1</comment_count>
    <who name="Michael Kay">mike</who>
    <bug_when>2005-09-26 13:41:00 +0000</bug_when>
    <thetext>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.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>6530</commentid>
    <comment_count>2</comment_count>
    <who name="Don Chamberlin">chamberl</who>
    <bug_when>2005-09-28 14:02:34 +0000</bug_when>
    <thetext>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&apos;s. Since you labeled your comment as editorial and it was 
accepted by the working group, I have marked your comment as &quot;Closed.&quot; Please 
feel free to reopen the comment if you have any further concerns or suggestions.
Regards,
Don Chamberlin</thetext>
  </long_desc>
      
      

    </bug>

</bugzilla>