<div dir="ltr"><div>I get following message:</div><div><br></div><div>> Submission rejected as potential spam<br></div><div>> SpamBayes determined spam probability of 74.83<br></div><div><br></div><div>SpamBayes seems to hate new users...</div><div><div><br></div><div>This is after trying to submit following bug report:</div><div><br></div>Executive summary page( <a href="http://twistedmatrix.com/documents/current/core/howto/vision.html">http://twistedmatrix.com/documents/current/core/howto/vision.html</a>) is probably first thing user will read when she visits Twisted page. At the moment this page is not providing important information about Twisted.<br><br>What is missing and what should be present in introduction to Twisted:<br><br>* explanation of difference between non-blocking and blocking IO<br>* what is reactor, why is it important (mention of reactor design pattern)<br>* introduction to core concepts of Twisted: protocol, factory,  defferred etc</div><div><br>It should be simple and easy to understand explanation that could give total noob overview of framework.</div><div><br>I also think some paragraphs are misleading and not very informative, for example:<br><br>> While Python by itself is a very powerful language, there are many facilities it lacks which other languages have spent great attention to adding. <br><br>It sounds very vague and  it is probably not true now isn't it? Python3 has its own async libraries in standard library so this sentence is misleading. <br><br>> It began as a game, it is being used commercially in games, and it will be, I hope, an interactive and entertaining experience for the end-user.<br><br><div>this could also appear misleading for newbie. New user will probably visit docs to learn more about networking, information about usage of twisted in games may not be relevant for most use cases. It should not be first thing user reads when she visits introduction. </div></div><div><br></div><div>> <span style="color:rgb(0,0,0);font-family:'trebuchet ms',verdana,arial,'Bitstream Vera Sans',helvetica,sans-serif;font-size:13px">As a platform, Twisted should be focused on integration. Ideally, all functionality will be accessible through all protocols.</span><span style="color:rgb(0,0,0);font-family:'trebuchet ms',verdana,arial,'Bitstream Vera Sans',helvetica,sans-serif;font-size:13px"> </span></div><div><span style="color:rgb(0,0,0);font-family:'trebuchet ms',verdana,arial,'Bitstream Vera Sans',helvetica,sans-serif;font-size:13px"><br></span></div><div><font color="#000000" face="trebuchet ms, verdana, arial, Bitstream Vera Sans, helvetica, sans-serif">At this point user knows nothing about protocols and knows little about functionality of Twisted so this sentence will probably not mean much for newbie. </font></div><div><br></div></div>