From mi@blue.virtual-estates.net  Mon Sep 19 17:54:28 2005
Return-Path: <mi@blue.virtual-estates.net>
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id DFB4116A41F
	for <FreeBSD-gnats-submit@freebsd.org>; Mon, 19 Sep 2005 17:54:28 +0000 (GMT)
	(envelope-from mi@blue.virtual-estates.net)
Received: from blue.virtual-estates.net (aldan.algebra.com [216.254.65.224])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 7221543D45
	for <FreeBSD-gnats-submit@freebsd.org>; Mon, 19 Sep 2005 17:54:26 +0000 (GMT)
	(envelope-from mi@blue.virtual-estates.net)
Received: from blue.virtual-estates.net (blue [127.0.0.1])
	by blue.virtual-estates.net (8.13.4/8.13.4) with ESMTP id j8JHsNGp025963
	(version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO)
	for <FreeBSD-gnats-submit@freebsd.org>; Mon, 19 Sep 2005 13:54:25 -0400 (EDT)
	(envelope-from mi@blue.virtual-estates.net)
Received: (from mi@localhost)
	by blue.virtual-estates.net (8.13.4/8.13.4/Submit) id j8JHsNCe025962;
	Mon, 19 Sep 2005 13:54:23 -0400 (EDT)
	(envelope-from mi)
Message-Id: <200509191754.j8JHsNCe025962@blue.virtual-estates.net>
Date: Mon, 19 Sep 2005 13:54:23 -0400 (EDT)
From: Mikhail Teterin <mi@aldan.algebra.com>
To: FreeBSD-gnats-submit@freebsd.org
Subject: bikeshed entry of Handbook is wrong
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         86342
>Category:       docs
>Synopsis:       bikeshed entry of Handbook is wrong
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    dougb
>State:          closed
>Quarter:        
>Keywords:       handbook
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Mon Sep 19 18:00:38 GMT 2005
>Closed-Date:    Sun Feb 27 03:56:03 UTC 2011
>Last-Modified:  Sun Feb 27 04:00:25 UTC 2011
>Originator:     Mikhail Teterin
>Release:        FreeBSD 5.4-STABLE i386
>Organization:
Virtual Estates, Inc.
>Environment:

>Description:
	The doc on the "bikeshed" term, such as:

	http://www.freebsd.org/doc/en_US.ISO8859-1/articles/mailing-list-faq/bikeshed.html
	is wrong. It wrongly describes the "bikeshed" argument as
	anything, where there is no consensus -- "sh vs. csh" would
	qualify.

	The correct explanation in FAQ is linked to, and is quite
	different from that of the Handbook.

>How-To-Repeat:

>Fix:

	How about:

	"... However, in FreeBSD parlance, the word is a derogatory
	term that refers to any argument about a non-essential part
	of a proposed change, fix, or idea. Sometimes such arguments
	overshadow the discussion of the essential parts much to the
	detriment of progress. (The genesis of the ..."

	The second paragraph -- beginning with "More generally..." --
	should be removed altogether.
>Release-Note:
>Audit-Trail:

From: Nate Eldredge <nge@cs.hmc.edu>
To: bug-followup@FreeBSD.org, mi@aldan.algebra.com
Cc:  
Subject: Re: docs/86342: bikeshed entry of Handbook is wrong
Date: Thu, 13 Oct 2005 15:56:53 -0700 (PDT)

 Okay, but I think "derogatory" should be changed to "disparaging" and 
 "essential parts" should be changed to "basic features".
 
 ;-)
 
 -- 
 Nate Eldredge
 nge@cs.hmc.edu

From: Eitan Adler <eadler@freebsd.org>
To: bug-followup@freebsd.org, mi@aldan.algebra.com
Cc:  
Subject: Re: docs/86342: bikeshed entry of Handbook is wrong
Date: Fri, 25 Feb 2011 13:50:23 -0500

 Since no one else opted to do this I decided to actually make the patch
 
 
 Index: article.sgml
 ===================================================================
 RCS file: /home/ncvs/doc/en_US.ISO8859-1/articles/mailing-list-faq/article.sgml,v
 retrieving revision 1.8
 diff -u -r1.8 article.sgml
 --- article.sgml	14 Nov 2009 22:20:12 -0000	1.8
 +++ article.sgml	25 Feb 2011 18:29:45 -0000
 @@ -492,12 +492,10 @@
      <title>What Is A "Bikeshed"?</title>
        <para>Literally, a <literal>bikeshed</literal> is a small outdoor
  	shelter into which one may store one's two-wheeled form of
 -	transportation.  However, in &os; parlance, the word is a
 -	derogatory term that refers to any oft-recurring discussion
 -	about a particular subject; in particular, it is most often used
 -	to refer to a topic which has never reached a consensus within
 -	the &os; community, and instead remains controversial.  (The
 -	genesis of this term is explained in more detail <ulink
 +	transportation.  However, in &os; parlance, the word is
 +	a metaphor indicating that you need not argue about every
 +	little feature just because you know enough to do so.
 +	(The genesis of this term is explained in more detail <ulink
  	url="&url.books.faq;/misc.html#BIKESHED-PAINTING">
  	in this document</ulink>).  You simply must have a working
  	knowledge of this concept before posting to any &os; mailing
 
 
 -- 
 Eitan Adler

From: "Mikhail T." <mi+thun@aldan.algebra.com>
To: Eitan Adler <eadler@freebsd.org>
Cc: bug-followup@freebsd.org
Subject: Re: docs/86342: bikeshed entry of Handbook is wrong
Date: Fri, 25 Feb 2011 14:09:24 -0500

 On 25.02.2011 13:50, Eitan Adler wrote:
 > +	transportation.  However, in&os; parlance, the word is
 Actually, if no other operating system's community has this particular 
 concept defined, perhaps, we should explicitly use "FreeBSD" here, 
 rather than the variable &os;? Yours,
 
     -mi
 
State-Changed-From-To: open->suspended 
State-Changed-By: eadler 
State-Changed-When: Fri Feb 25 21:09:10 EST 2011 
State-Changed-Why:  
*sigh* - this generates more bikeshed then its worth. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=86342 
State-Changed-From-To: suspended->closed 
State-Changed-By: dougb 
State-Changed-When: Sun Feb 27 03:54:37 UTC 2011 
State-Changed-Why:  

Put on my doc committer hat for a second and address the concern 
in this PR albeit with a different solution. 


Responsible-Changed-From-To: freebsd-doc->dougb 
Responsible-Changed-By: dougb 
Responsible-Changed-When: Sun Feb 27 03:54:37 UTC 2011 
Responsible-Changed-Why:  

I'm wearing the asbestos undies atm. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=86342 

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/86342: commit references a PR
Date: Sun, 27 Feb 2011 03:54:27 +0000 (UTC)

 dougb       2011-02-27 03:54:21 UTC
 
   FreeBSD doc repository
 
   Modified files:
     en_US.ISO8859-1/articles/mailing-list-faq article.sgml 
   Log:
   Address the concern in the PR with a simpler explanation and
   emphasis on the Handbook article which has a good description.
   
   PR:             docs/86342
   Submitted by:   Mikhail Teterin <mi@aldan.algebra.com>
   
   Revision  Changes    Path
   1.9       +5 -8      doc/en_US.ISO8859-1/articles/mailing-list-faq/article.sgml
 _______________________________________________
 cvs-all@freebsd.org mailing list
 http://lists.freebsd.org/mailman/listinfo/cvs-all
 To unsubscribe, send any mail to "cvs-all-unsubscribe@freebsd.org"
 
>Unformatted:
