<?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>24944</bug_id>
          
          <creation_ts>2014-03-05 20:49:37 +0000</creation_ts>
          <short_desc>Ensure references are consistent and correctly categorized</short_desc>
          <delta_ts>2014-11-07 01:34:33 +0000</delta_ts>
          <reporter_accessible>1</reporter_accessible>
          <cclist_accessible>1</cclist_accessible>
          <classification_id>1</classification_id>
          <classification>Unclassified</classification>
          <product>Web Cryptography</product>
          <component>Web Cryptography API Document</component>
          <version>unspecified</version>
          <rep_platform>PC</rep_platform>
          <op_sys>All</op_sys>
          <bug_status>RESOLVED</bug_status>
          <resolution>FIXED</resolution>
          
          
          <bug_file_loc></bug_file_loc>
          <status_whiteboard></status_whiteboard>
          <keywords></keywords>
          <priority>P2</priority>
          <bug_severity>minor</bug_severity>
          <target_milestone>---</target_milestone>
          
          
          <everconfirmed>1</everconfirmed>
          <reporter name="Mark Watson">watsonm</reporter>
          <assigned_to name="Mark Watson">watsonm</assigned_to>
          <cc>sleevi</cc>
    
    <cc>virginie.galindo</cc>
          
          

      

      

      

          <comment_sort_order>oldest_to_newest</comment_sort_order>  
          <long_desc isprivate="0" >
    <commentid>101917</commentid>
    <comment_count>0</comment_count>
    <who name="Mark Watson">watsonm</who>
    <bug_when>2014-03-05 20:49:37 +0000</bug_when>
    <thetext>References should be consistently written as [REF] in square brackets.

References need to be correctly categorized as normative or informative.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>101930</commentid>
    <comment_count>1</comment_count>
    <who name="Ryan Sleevi">sleevi</who>
    <bug_when>2014-03-05 22:00:18 +0000</bug_when>
    <thetext>So, it needs to be clarified

The [REF] form is for referring to the short-hand identifier of a spec that appears within the references section. However, there are still times where we want to say the full part of the specification.

Something like

&quot;Refer to Section 3 of PKCS #11 [PKCS11]&quot;

Presumably</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>101932</commentid>
    <comment_count>2</comment_count>
    <who name="Mark Watson">watsonm</who>
    <bug_when>2014-03-05 22:02:26 +0000</bug_when>
    <thetext>(In reply to Ryan Sleevi from comment #1)
&gt; So, it needs to be clarified
&gt; 
&gt; The [REF] form is for referring to the short-hand identifier of a spec that
&gt; appears within the references section. However, there are still times where
&gt; we want to say the full part of the specification.
&gt; 
&gt; Something like
&gt; 
&gt; &quot;Refer to Section 3 of PKCS #11 [PKCS11]&quot;
&gt; 
&gt; Presumably

I would say &quot;Refer to Section 3 of [PKCS11]&quot;</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>113072</commentid>
    <comment_count>3</comment_count>
    <who name="">virginie.galindo</who>
    <bug_when>2014-10-14 09:01:51 +0000</bug_when>
    <thetext>In order to progress towards exit to Last Call for the Web Crypto API, the chair suggests the following resolution for that bug. 

Resolution : Bug RESOLVED, editors will edit the specification to harmonize with consistent usage of specification references and/or section of specification reference. 

If none objects before the 20th of Oct @20:00 UTC, this resolution will be endorsed.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>114630</commentid>
    <comment_count>4</comment_count>
    <who name="Mark Watson">watsonm</who>
    <bug_when>2014-11-07 01:34:33 +0000</bug_when>
    <thetext>https://dvcs.w3.org/hg/webcrypto-api/rev/586d852d2679</thetext>
  </long_desc>
      
      

    </bug>

</bugzilla>