Date: Mon, 19 Sep 2005 13:54:23 -0400 (EDT) From: Mikhail Teterin <mi@aldan.algebra.com> To: FreeBSD-gnats-submit@FreeBSD.org Subject: docs/86342: bikeshed entry of Handbook is wrong Message-ID: <200509191754.j8JHsNCe025962@blue.virtual-estates.net> Resent-Message-ID: <200509191800.j8JI0cXM077893@freefall.freebsd.org>
next in thread | raw e-mail | index | archive | help
>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:
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?200509191754.j8JHsNCe025962>