discussion_policy.htm 6.1 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118
  1. <html>
  2. <head>
  3. <meta http-equiv="Content-Type" content="text/html; charset=windows-1252">
  4. <meta name="GENERATOR" content="Microsoft FrontPage 4.0">
  5. <meta name="ProgId" content="FrontPage.Editor.Document">
  6. <title>Boost Discussion Policy</title>
  7. </head>
  8. <body bgcolor="#FFFFFF" text="#000000">
  9. <table border="1" bgcolor="#007F7F" cellpadding="2">
  10. <tr>
  11. <td bgcolor="#FFFFFF"><img src="../c++boost.gif" alt="c++boost.gif (8819 bytes)" width="277" height="86"></td>
  12. <td><a href="../index.htm"><font face="Arial" color="#FFFFFF"><big>Home</big></font></a></td>
  13. <td><a href="../libs/libraries.htm"><font face="Arial" color="#FFFFFF"><big>Libraries</big></font></a></td>
  14. <td><a href="../people/people.htm"><font face="Arial" color="#FFFFFF"><big>People</big></font></a></td>
  15. <td><a href="faq.htm"><font face="Arial" color="#FFFFFF"><big>FAQ</big></font></a></td>
  16. <td><a href="index.htm"><font face="Arial" color="#FFFFFF"><big>More</big></font></a></td>
  17. </tr>
  18. </table>
  19. <h1>Boost Discussion Policy</h1>
  20. <p>Email discussion is the tie that binds boost members together into a community.
  21. If the discussion is stimulating and effective, the community thrives.&nbsp; If
  22. the discussion degenerates into name calling and ill will, the community withers
  23. and dies.</p>
  24. <h2>Acceptable topics</h2>
  25. <ul>
  26. <li>Queries to determine interest in a possible library submission.</li>
  27. <li>Technical discussions about a proposed or existing library, including bug
  28. reports and requests for help.</li>
  29. <li>Formal Reviews of proposed libraries.</li>
  30. <li>Reports of user experiences with Boost libraries.</li>
  31. <li>Boost administration or policies.</li>
  32. <li>Compiler specific workarounds as applied to Boost libraries.</li>
  33. </ul>
  34. <p>Other topics related to boost development may be acceptable, at the discretion of moderators. If unsure, go ahead and post. The moderators
  35. will let you know.</p>
  36. <h2>Unacceptable topics</h2>
  37. <ul>
  38. <li>Advertisements for commercial products.</li>
  39. <li>Requests for help getting non-boost code to compile with your compiler.
  40. Try the comp.lang.c++.moderated newsgroup instead.</li>
  41. <li>Requests for help interpreting the C++ standard.&nbsp; Try the comp.std.c++
  42. newsgroup instead.</li>
  43. <li>Job offers.</li>
  44. </ul>
  45. <h2>Prohibited behavior</h2>
  46. <p>Prohibited behavior will not be tolerated.&nbsp; The moderators will ban
  47. postings by abusers.</p>
  48. <h3>Flame wars</h3>
  49. <p>Personal insults, argument for the sake of argument, and all the other
  50. behaviors which fall into the &quot;flame war&quot; category are
  51. prohibited.&nbsp; Discussions should focus on technical arguments, not the
  52. personality traits or motives of participants.</p>
  53. <h3>Third-party attacks</h3>
  54. <p>Attacks on third parties such as software vendors, hardware vendors, or any
  55. other organizations, are prohibited.&nbsp; Boost exists to unite and serve the
  56. entire C++ community, not to disparage the work of others.</p>
  57. <p>Does this mean that we ban the occasional complaint or wry remark about a
  58. troublesome compiler?&nbsp; No, but be wary of overdoing it.</p>
  59. <h3>Off-topic posts</h3>
  60. <p>Discussions which stray from the acceptable topics are strongly discouraged.
  61. While off-topic posts are often well meaning and not as individually corrosive
  62. as other abuses, cumulatively the distraction damages the effectiveness of
  63. discussion.</p>
  64. <h2>Culture</h2>
  65. <p>In addition to technical skills, Boost members value collaboration,
  66. acknowledgement of the help of others, and a certain level of politeness.&nbsp; Boost
  67. membership is very international, and ranges widely in age and other
  68. characteristics. Think of discussion as occurring among colleagues in a widely read forum, rather
  69. than among a few close friends.</p>
  70. <p>Always remember that the cumulative effort spent by people reading
  71. your contribution scales with the (already large) number of boost
  72. members. Thus, do invest time and effort to make your message as
  73. readable as possible. Adhere to English syntax and grammar rules such
  74. as proper capitalization. Avoid copious informalism, colloquial
  75. language, or abbreviations, they may not be understood by all readers.
  76. Re-read your message before submitting it.</p>
  77. <h2>Guidelines for effective discussions</h2>
  78. <p>Apply social engineering to prevent heated technical discussion from
  79. degenerating into a shouting match.</p>
  80. <ul>
  81. <li>Questions help.&nbsp; If someone suggests something that you don't think
  82. will work, then replying with a question like &quot;will that compile?&quot;
  83. or &quot;won't that fail to compile, or am I missing something?&quot; is a
  84. lot smoother than &quot;That's really stupid - it won't compile.&quot;&nbsp;
  85. Saying &quot;that fails to compile for me, and seems to violate section
  86. n.n.n of the standard&quot; would be yet another way to be firm without
  87. being abrasive.</li>
  88. <li>If most of the discussion has been code-free generalities, posting a bit
  89. of sample code can focus people on the practical issues.</li>
  90. <li>If most of the discussion has been in terms of specific code, try to talk
  91. a bit about hidden assumptions and generalities that may be preventing
  92. discussion closure.</li>
  93. <li>Taking a time-out is often effective.&nbsp; Just say: &quot;Let me think
  94. about that for a day or two.&nbsp; Let's take a time-out to digest the
  95. discussion so far.&quot;</li>
  96. </ul>
  97. <p>Avoid Parkinson's Bicycle Shed.&nbsp; Parkinson described a committee formed
  98. to oversee design of an early nuclear power plant.&nbsp; There were three agenda
  99. items - when to have tea, where to put the bicycle shed, and how to
  100. ensure nuclear safety.&nbsp; Tea was was disposed of quickly as trivial.&nbsp;&nbsp;
  101. Nuclear safety was discussed for only
  102. an hour - it was so complex, scary, and technical that even
  103. among experts few felt comfortable with the issues.&nbsp; Endless days were then
  104. spent discussing where to put the bicycle shed (the parking lot would
  105. be a modern equivalent) because everyone
  106. understood the issues and felt comfortable discussing them.&nbsp;</p>
  107. <hr>
  108. <p>Revised <!--webbot bot="Timestamp" S-Type="EDITED" S-Format="%d %B, %Y" startspan -->14 June, 2001<!--webbot bot="Timestamp" endspan i-checksum="38309" -->
  109. </p>
  110. </body>
  111. </html>
粤ICP备19079148号