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

<bugzilla version="5.0.6"
          urlbase="https://bugzilla.yoctoproject.org/"
          
          maintainer="it-coreprojects-helpdesk@linuxfoundation.org"
>

    <bug>
          <bug_id>7832</bug_id>
          
          <creation_ts>2015-06-01 12:26:12 +0000</creation_ts>
          <short_desc>The default for the field &quot;Documentation Change&quot; is not really a default.</short_desc>
          <delta_ts>2015-06-03 12:34:21 +0000</delta_ts>
          <reporter_accessible>1</reporter_accessible>
          <cclist_accessible>1</cclist_accessible>
          <classification_id>5</classification_id>
          <classification>Infrastructure</classification>
          <product>Bugzilla</product>
          <component>bugzilla</component>
          <version>unspecified</version>
          <rep_platform>x86</rep_platform>
          <op_sys>Multiple</op_sys>
          <bug_status>RESOLVED</bug_status>
          <resolution>FIXED</resolution>
          
          
          <bug_file_loc></bug_file_loc>
          <status_whiteboard></status_whiteboard>
          <keywords></keywords>
          <priority>Low</priority>
          <bug_severity>enhancement</bug_severity>
          <target_milestone>---</target_milestone>
          
          
          <everconfirmed>1</everconfirmed>
          <reporter name="Igor Stoppa">igor.stoppa</reporter>
          <assigned_to name="Michael Halstead">mhalstead</assigned_to>
          <cc>infras.bug.watcher</cc>
    
    <cc>Infras.watcher</cc>
    
    <cc>srifenbark</cc>
          
          
          <cf_os>---</cf_os>
          <cf_regression_type>---</cf_regression_type>
          
          <cf_docchange>No (bug/feature does not impact docs)</cf_docchange>

      

      

      

          <comment_sort_order>oldest_to_newest</comment_sort_order>  
          <long_desc isprivate="0" >
    <commentid>51379</commentid>
    <comment_count>0</comment_count>
    <who name="Igor Stoppa">igor.stoppa</who>
    <bug_when>2015-06-01 12:26:12 +0000</bug_when>
    <thetext>Try to create a bug report and do not select a value for &quot;Documentation Change&quot; - bugzilla will complain that the value is unset.

Only to let you choose among vastious options, one of which is named &quot;Undecided (default)&quot;. Only, it&apos;s not.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>51397</commentid>
    <comment_count>1</comment_count>
    <who name="Michael Halstead">mhalstead</who>
    <bug_when>2015-06-01 18:44:54 +0000</bug_when>
    <thetext>Default in this case doesn&apos;t mean it is selected by default in the interface. It means this option should be selected by the user if no options are appropriate. 

If we changed the label to &quot;Undecided or Not Applicable&quot; would that clarify the selection?</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>51431</commentid>
    <comment_count>2</comment_count>
    <who name="Igor Stoppa">igor.stoppa</who>
    <bug_when>2015-06-02 19:27:52 +0000</bug_when>
    <thetext>(In reply to comment #1)
&gt; It means this option should be selected by the user if no options
&gt; are appropriate. 

That smells like a real default to me :-D

Chances are that if the reporter can really answer that question, (s)he also knows about the option and will set it anyway.

For everyone else I think it would be just confusing.

But you guys know how many bugs have that field set to something else than the pseudo-default ... if they are not too many, you could just make it a real default and be friendlier toward bug reporters :-)

What I find really confusing is that there is that &quot;(default)&quot; in the option, but it still requires manual selection.

Imho that &quot;(default)&quot; should just go away.

If it&apos;s really default, make it so also from bugzilla perspective.

If it&apos;s not default, drop the string which states otherwise.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>51441</commentid>
    <comment_count>3</comment_count>
    <who name="Michael Halstead">mhalstead</who>
    <bug_when>2015-06-02 21:59:46 +0000</bug_when>
    <thetext>In the initial design we wanted people to have to make this decision when a new bug was opened. 

I&apos;ve changed the label to hopefully be more clear.

Perhaps we&apos;ve had this in place long enough that we don&apos;t need people to choose an option anymore and can have &quot;Undecided&quot; as the default in the interface.

Scott can you comment?</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>51442</commentid>
    <comment_count>4</comment_count>
    <who name="Scott Rifenbark">srifenbark</who>
    <bug_when>2015-06-02 22:21:34 +0000</bug_when>
    <thetext>Hi, 

To me, &quot;Not Applicable&quot; is equivalent to &quot;No&quot;.  I think you should have 4 choices here:

 1. I don&apos;t know
 2. No
 3. Yes
 4. Done

&quot;Undecided&quot; implies that the user can&apos;t decide between &quot;Yes&quot; or &quot;No&quot;.  They do not understand whether a fix will impact the docs or not.  I think it would be clearer if we just had a selection called &quot;I don&apos;t know&quot;.  &quot;Undecided&quot; could mean some some strange factor is keeping them from making a decision between &quot;Yes&quot; and &quot;No&quot;.  A person that files a bug will either understand if a doc change is needed or not.  If not, they don&apos;t know.  

I think it is fine that Bugzilla still complains if you don&apos;t put a choice in for the doc flag.  There should be no default for this flag IMO.

I think we need some awareness also on how to use this flag in the bigger picture.  Example, a bug gets filed for some issue and the assignee is some engineer.  The flag for docs is set to &quot;Yes&quot;.  The engineer researches and implements a fix.  Maybe QA even looks at the fix (maybe not, either way would work).  At that point, the bug should be assigned to the doc person since that part of the fix is still missing.  Once the doc part is fixed then it can be set to RESOLVED.  That is my opinion.

Scott</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>51448</commentid>
    <comment_count>5</comment_count>
    <who name="Michael Halstead">mhalstead</who>
    <bug_when>2015-06-03 00:40:06 +0000</bug_when>
    <thetext>Updated choices to include &quot;Don&apos;t know&quot;. Please let me know if the new option label causes any trouble.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>51473</commentid>
    <comment_count>6</comment_count>
    <who name="Scott Rifenbark">srifenbark</who>
    <bug_when>2015-06-03 12:34:21 +0000</bug_when>
    <thetext>What does the &quot;--&quot; mean from the doc flag pull down?</thetext>
  </long_desc>
      
      

    </bug>

</bugzilla>