<?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>27557</bug_id>
          
          <creation_ts>2014-12-10 17:52:32 +0000</creation_ts>
          <short_desc>Consider introducing a prose-friendly way to refer to enumerations</short_desc>
          <delta_ts>2016-10-22 16:41:46 +0000</delta_ts>
          <reporter_accessible>1</reporter_accessible>
          <cclist_accessible>1</cclist_accessible>
          <classification_id>1</classification_id>
          <classification>Unclassified</classification>
          <product>WebAppsWG</product>
          <component>WebIDL</component>
          <version>unspecified</version>
          <rep_platform>PC</rep_platform>
          <op_sys>All</op_sys>
          <bug_status>RESOLVED</bug_status>
          <resolution>WORKSFORME</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="Anne">annevk</reporter>
          <assigned_to name="Cameron McCormack">cam</assigned_to>
          <cc>d</cc>
    
    <cc>jackalmage</cc>
    
    <cc>mike</cc>
    
    <cc>public-script-coord</cc>
    
    <cc>travil</cc>
          
          <qa_contact>public-webapps-bugzilla</qa_contact>

      

      

      

          <comment_sort_order>oldest_to_newest</comment_sort_order>  
          <long_desc isprivate="0" >
    <commentid>116098</commentid>
    <comment_count>0</comment_count>
    <who name="Anne">annevk</who>
    <bug_when>2014-12-10 17:52:32 +0000</bug_when>
    <thetext>Context:

  https://www.w3.org/Bugs/Public/show_bug.cgi?id=27543
  https://fetch.spec.whatwg.org/

Perhaps we should standardize on a convention on how to reference an enumeration value in a way that is not awful to read. Fetch currently maps /no CORS/ to &quot;no-cors&quot; but that gets somewhat verbose. On the other hand, I&apos;d rather not use &quot;no-cors&quot; throughout the specification as that is harder to read.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>116100</commentid>
    <comment_count>1</comment_count>
    <who name="Domenic Denicola">d</who>
    <bug_when>2014-12-10 17:54:54 +0000</bug_when>
    <thetext>To me just using the string values throughout makes the most sense.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>116103</commentid>
    <comment_count>2</comment_count>
    <who name="Tab Atkins Jr.">jackalmage</who>
    <bug_when>2014-12-10 18:50:05 +0000</bug_when>
    <thetext>Yeah, I don&apos;t understand what&apos;s hard to read about using the literal string value.  Seems fine to me.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>116217</commentid>
    <comment_count>3</comment_count>
    <who name="Anne">annevk</who>
    <bug_when>2014-12-12 15:12:14 +0000</bug_when>
    <thetext>Once e.g. background-image and friends are defined in terms of Fetch it seems rather ugly to have prose such as

  Let /request/ be a new request whose mode is &quot;no-cors&quot; ...

instead of 

  Let /request/ be a new request whose mode is /no CORS/ ...

but perhaps it is okay.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>116220</commentid>
    <comment_count>4</comment_count>
    <who name="Tab Atkins Jr.">jackalmage</who>
    <bug_when>2014-12-12 15:19:18 +0000</bug_when>
    <thetext>Yes, that seems totally fine to me.  And will usually be much clearer, because it refers directly to the API surface in an intuitive way, rather than requiring a mapping between an abstract value and the actual enumeration that was passed in.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>116246</commentid>
    <comment_count>5</comment_count>
    <who name="Travis Leithead [MSFT]">travil</who>
    <bug_when>2014-12-13 00:42:38 +0000</bug_when>
    <thetext>Keep it simple :)</thetext>
  </long_desc>
      
      

    </bug>

</bugzilla>