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>
This commit is contained in:
Doug Barton 2011-02-27 03:54:21 +00:00
parent 1d35bbb978
commit 5c6fcf9ad1
Notes: svn2git 2020-12-08 03:00:23 +00:00
svn path=/head/; revision=36992

View file

@ -484,22 +484,19 @@
some questions recur more often than others, sometimes as followups some questions recur more often than others, sometimes as followups
where the subject line no longer accurately reflects the new content. where the subject line no longer accurately reflects the new content.
Nevertheless, the burden is on you, the poster, to do your homework Nevertheless, the burden is on you, the poster, to do your homework
to help avoid these recurring topics, and especially the dreaded to help avoid these recurring topics.</para>
<literal>bikeshed</literal>s.</para>
</sect1> </sect1>
<sect1 id="bikeshed"> <sect1 id="bikeshed">
<title>What Is A "Bikeshed"?</title> <title>What Is A "Bikeshed"?</title>
<para>Literally, a <literal>bikeshed</literal> is a small outdoor <para>Literally, a <literal>bikeshed</literal> is a small outdoor
shelter into which one may store one's two-wheeled form of shelter into which one may store one's two-wheeled form of
transportation. However, in &os; parlance, the word is a transportation. However, in &os; parlance, the term refers to
derogatory term that refers to any oft-recurring discussion topics that are simple enough that (nearly) anyone can offer an
about a particular subject; in particular, it is most often used opinion about, and often (nearly) everyone does. The
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 genesis of this term is explained in more detail <ulink
url="&url.books.faq;/misc.html#BIKESHED-PAINTING"> url="&url.books.faq;/misc.html#BIKESHED-PAINTING">
in this document</ulink>). You simply must have a working in this document</ulink>. You simply must have a working
knowledge of this concept before posting to any &os; mailing knowledge of this concept before posting to any &os; mailing
list.</para> list.</para>