docs/86342: bikeshed entry of Handbook is wrong



>Number:         86342
>Category:       docs
>Synopsis:       bikeshed entry of Handbook is wrong
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Mon Sep 19 18:00:38 GMT 2005
>Closed-Date:
>Last-Modified:
>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:
>Unformatted:
_______________________________________________
freebsd-doc@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/freebsd-doc
To unsubscribe, send any mail to "freebsd-doc-unsubscribe@freebsd.org"