discussion_policy.htm 9.2 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197
  1. <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
  2. <html>
  3. <head>
  4. <meta http-equiv="Content-Type" content="text/html; charset=windows-1252">
  5. <meta name="GENERATOR" content="Microsoft FrontPage 5.0">
  6. <meta name="ProgId" content="FrontPage.Editor.Document">
  7. <title>Boost Discussion Policy</title>
  8. </head>
  9. <body bgcolor="#FFFFFF" text="#000000">
  10. <table border="1" bgcolor="#007F7F" cellpadding="2">
  11. <tr>
  12. <td bgcolor="#FFFFFF">
  13. <img src="../c++boost.gif" alt="c++boost.gif (8819 bytes)" width="277" height="86"></td>
  14. <td><a href="../index.htm"><font face="Arial" color="#FFFFFF"><big>Home</big></font></a></td>
  15. <td><a href="../libs/libraries.htm"><font face="Arial" color="#FFFFFF"><big>Libraries</big></font></a></td>
  16. <td><a href="../people/people.htm"><font face="Arial" color="#FFFFFF"><big>People</big></font></a></td>
  17. <td><a href="faq.htm"><font face="Arial" color="#FFFFFF"><big>FAQ</big></font></a></td>
  18. <td><a href="index.htm"><font face="Arial" color="#FFFFFF"><big>More</big></font></a></td>
  19. </tr>
  20. </table>
  21. <h1>Boost Discussion Policy</h1>
  22. <p>Email discussion is the tie that binds boost members together into a community.
  23. If the discussion is stimulating and effective, the community thrives. If
  24. the discussion degenerates into name calling and ill will, the community withers
  25. and dies.</p>
  26. <h2>Contents</h2>
  27. <dl>
  28. <dt><a href="#acceptable">Acceptable Topics</a><dd>
  29. <dt><a href="#unacceptable">Unacceptable Topics</a><dd>
  30. <dt><a href="#quoting">Quoting and Message Size</a><dd>
  31. <dt><a href="#behavior">Prohibited Behavior</a><dd>
  32. <dt><a href="#culture">Culture</a><dd>
  33. </dl>
  34. <h2><a name="acceptable"></a>Acceptable topics</h2>
  35. <ul>
  36. <li>Queries to determine interest in a possible library submission.</li>
  37. <li>Technical discussions about a proposed or existing library, including bug
  38. reports and requests for help.</li>
  39. <li>Formal Reviews of proposed libraries.</li>
  40. <li>Reports of user experiences with Boost libraries.</li>
  41. <li>Boost administration or policies.</li>
  42. <li>Compiler specific workarounds as applied to Boost libraries.</li>
  43. </ul>
  44. <p>Other topics related to boost development may be acceptable, at the discretion of moderators. If unsure, go ahead and post. The moderators
  45. will let you know.</p>
  46. <h2><a name="unacceptable"></a>Unacceptable topics</h2>
  47. <ul>
  48. <li>Advertisements for commercial products.</li>
  49. <li>Requests for help getting non-boost code to compile with your compiler.
  50. Try the comp.lang.c++.moderated newsgroup instead.</li>
  51. <li>Requests for help interpreting the C++ standard. Try the comp.std.c++
  52. newsgroup instead.</li>
  53. <li>Job offers.</li>
  54. <li>Requests for solutions to homework assignments.</ul>
  55. <h2><a name="quoting"></a>Quoting and Message Size</h2>
  56. <p>Please <b>limit the amount of quoted text</b> in replies to this
  57. list. Some people have to pay for, or wait for, each byte that they
  58. download from the list. More importantly, it will save time and make
  59. your post more valuable when readers do not have to find out which
  60. exact part of a previous message you are responding to.
  61. <p>A common and very useful approach is to cite the small fractions of
  62. the message you are actually responding to and to put your response
  63. directly beneath each citation, with a blank line separating them for
  64. readability:
  65. <blockquote>
  66. <pre>
  67. &gt; Some part of a paragraph that you wish to reply to goes
  68. &gt; here; there may be several lines.
  69. Your response to that part of the message goes here. There may,
  70. of course, be several lines.
  71. &gt; The second part of the paragraph that is relevant to your
  72. &gt; reply goes here; agiain there may be several lines.
  73. Your response to the second part of the message goes here.
  74. ...
  75. </pre>
  76. </blockquote>
  77. For more information about effective use of quotation in posts, see <a
  78. href="http://www.netmeister.org/news/learn2quote.html">this helpful
  79. guide</a>.
  80. <p>A summary of the foregoing thread is only needed after a long
  81. discussion, especially when the topic is drifting or a result has been
  82. achieved in a discussion. The mail system will do the tracking that
  83. is needed to enable mail readers to display message threads (and every
  84. decent mail reader supports that).
  85. <p>If you ever have to refer to single message earlier in a thread or
  86. in a different thread then you can use a URL to the <a
  87. href="mailing_lists.htm#archive">message archives</a>. To help to
  88. keep those URLs short, you can use <a
  89. href="http://www.tinyurl.com">tinyurl.com</a>. Citing the relevant
  90. portion of a message you link to is often helpful (if the citation is
  91. small).
  92. <p>Don't forget, it's a single writer but there are many readers.
  93. So, saving some time for the readers is worth spending extra
  94. time when writing a message.
  95. <p>The mailing list software automatically limits message and
  96. attachment size to a reasonable amount, typically 75K, which is
  97. adjusted from time-to-time by the moderators.. This limit is a
  98. courtesy to those who rely on dial-up Internet access.
  99. </p>
  100. <h2><a name="behavior"></a>Prohibited behavior</h2>
  101. <p>Prohibited behavior will not be tolerated. The moderators will ban
  102. postings by abusers.</p>
  103. <h3>Flame wars</h3>
  104. <p>Personal insults, argument for the sake of argument, and all the other
  105. behaviors which fall into the &quot;flame war&quot; category are
  106. prohibited. Discussions should focus on technical arguments, not the
  107. personality traits or motives of participants.</p>
  108. <h3>Third-party attacks</h3>
  109. <p>Attacks on third parties such as software vendors, hardware vendors, or any
  110. other organizations, are prohibited. Boost exists to unite and serve the
  111. entire C++ community, not to disparage the work of others.</p>
  112. <p>Does this mean that we ban the occasional complaint or wry remark about a
  113. troublesome compiler? No, but be wary of overdoing it.</p>
  114. <h3>Off-topic posts</h3>
  115. <p>Discussions which stray from the acceptable topics are strongly discouraged.
  116. While off-topic posts are often well meaning and not as individually corrosive
  117. as other abuses, cumulatively the distraction damages the effectiveness of
  118. discussion.</p>
  119. <h2><a name="culture"></a>Culture</h2>
  120. <p>In addition to technical skills, Boost members value collaboration,
  121. acknowledgement of the help of others, and a certain level of politeness. Boost
  122. membership is very international, and ranges widely in age and other
  123. characteristics. Think of discussion as occurring among colleagues in a widely read forum, rather
  124. than among a few close friends.</p>
  125. <p>Always remember that the cumulative effort spent by people reading
  126. your contribution scales with the (already large) number of boost
  127. members. Thus, do invest time and effort to make your message as
  128. readable as possible. Adhere to English syntax and grammar rules such
  129. as proper capitalization. Avoid copious informalism, colloquial
  130. language, or abbreviations, they may not be understood by all readers.
  131. Re-read your message before submitting it.</p>
  132. <h2>Guidelines for effective discussions</h2>
  133. <p>Apply social engineering to prevent heated technical discussion from
  134. degenerating into a shouting match, and to actively encourage the cooperation
  135. upon which Boost depends.</p>
  136. <ul>
  137. <li>Questions help. If someone suggests something that you don't think
  138. will work, then replying with a question like &quot;will that compile?&quot;
  139. or &quot;won't that fail to compile, or am I missing something?&quot; is a
  140. lot smoother than &quot;That's really stupid - it won't compile.&quot;&nbsp;
  141. Saying &quot;that fails to compile for me, and seems to violate section
  142. n.n.n of the standard&quot; would be yet another way to be firm without
  143. being abrasive.</li>
  144. <li>If most of the discussion has been code-free generalities, posting a bit
  145. of sample code can focus people on the practical issues.</li>
  146. <li>If most of the discussion has been in terms of specific code, try to talk
  147. a bit about hidden assumptions and generalities that may be preventing
  148. discussion closure.</li>
  149. <li>Taking a time-out is often effective. Just say: &quot;Let me think
  150. about that for a day or two. Let's take a time-out to digest the
  151. discussion so far.&quot;</li>
  152. </ul>
  153. <p>Avoid Parkinson's Bicycle Shed. Parkinson described a committee formed
  154. to oversee design of an early nuclear power plant. There were three agenda
  155. items - when to have tea, where to put the bicycle shed, and how to
  156. ensure nuclear safety. Tea was disposed of quickly as trivial.&nbsp;&nbsp;
  157. Nuclear safety was discussed for only
  158. an hour - it was so complex, scary, and technical that even
  159. among experts few felt comfortable with the issues. Endless days were then
  160. spent discussing where to put the bicycle shed (the parking lot would
  161. be a modern equivalent) because everyone
  162. understood the issues and felt comfortable discussing them.&nbsp;</p>
  163. <hr>
  164. <p>Revised <!--webbot bot="Timestamp" S-Type="EDITED" S-Format="%d %B, %Y" startspan -->02 October, 2003<!--webbot bot="Timestamp" i-checksum="38549" endspan -->
  165. </p>
  166. <p>© Beman Dawes 2000</p>
  167. <p> Use, modification, and distribution are subject to the Boost Software
  168. License, Version 1.0. (See accompanying file <a href="../LICENSE_1_0.txt">
  169. LICENSE_1_0.txt</a> or copy at <a href="http://www.boost.org/LICENSE_1_0.txt">
  170. www.boost.org/LICENSE_1_0.txt</a>)</p>
  171. </body>
  172. </html>
粤ICP备19079148号