<?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>28013</bug_id>
          
          <creation_ts>2015-02-13 21:06:03 +0000</creation_ts>
          <short_desc>Unnumbered Definitions – Unidentified Cross-References</short_desc>
          <delta_ts>2015-03-17 00:14:52 +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 3.1</component>
          <version>Candidate Recommendation</version>
          <rep_platform>PC</rep_platform>
          <op_sys>Linux</op_sys>
          <bug_status>CLOSED</bug_status>
          <resolution>DUPLICATE</resolution>
          <dup_id>28012</dup_id>
          
          <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="Patrick Durusau">patrick</reporter>
          <assigned_to name="Jonathan Robie">jonathan.robie</assigned_to>
          <cc>andrew_coleman</cc>
          
          <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>117895</commentid>
    <comment_count>0</comment_count>
    <who name="Patrick Durusau">patrick</who>
    <bug_when>2015-02-13 21:06:03 +0000</bug_when>
    <thetext>This is a duplicate of 28012 but on a different component. I was unable to select multiple components for a recurring issue in each component. Sorry.


“Definitions” have anchors that allow them to be addressed by cross-references, but you should note that cross-references are text hyperlinks that have no identifier by which a reader can find the definition without using the hyperlink. That is to say when I see:

***
A lexical QName with a prefix can be converted into an expanded QName by resolving its namespace prefix to a namespace URI, using the statically known namespaces. (in the paragraph following production [118] of XPath 3.1)
***

The hyperlinks in the original will take me to various parts of the document where these definitions occur, but if I have printed the document, I have no clue where to look for these definitions.

The better practice is to number all the definitions and since they are all self-contained, to put them in a single location. Additionally, all interlinear references to those definitions (or other internal cross-references) should have a visible reference that enables a reader to find the definition or cross-reference, without use of an internal hyperlink.

Example:

***
A lexical QName Def-21 with a prefix can be converted into an expanded QName Def-19 by resolving its namespace prefix to a namespace URI, using the statically known namespaces. Def-99 [These are fake links to draw your attention to the text in question. The Def numbers are fictitious in this example. Actual references would have the visible definition numbers assigned to the appropriate definition.]
***</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>118272</commentid>
    <comment_count>1</comment_count>
    <who name="Andrew Coleman">andrew_coleman</who>
    <bug_when>2015-03-04 14:11:33 +0000</bug_when>
    <thetext>Patrick, I acknowledge your point about there being no &apos;generic&apos; component, but in the interest of tidiness, I have marked this as a duplicate of the bug that contains the most discussion (28012).  Many thanks.

*** This bug has been marked as a duplicate of bug 28012 ***</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>118637</commentid>
    <comment_count>2</comment_count>
    <who name="Patrick Durusau">patrick</who>
    <bug_when>2015-03-17 00:14:52 +0000</bug_when>
    <thetext>See my comments at: https://www.w3.org/Bugs/Public/show_bug.cgi?id=28012</thetext>
  </long_desc>
      
      

    </bug>

</bugzilla>