有没有比官方网站更好的Twisted的详尽文档？

Question

我一直在看扭曲一段时间。它看起来很有趣 - 在编写服务器时，它似乎是一种利用大量功能的好方法。不幸的是，尽管使用twisted.web编写了一些Web服务器（从阅读其他人的来源和一本极其过时的O'Reilly书籍），我从未真正感觉到我已经达成了与扭曲的亲和关系......一定程度的理解实际上给了我我的一些力量。

我认为我需要一些好的文档才能达到更好的理解水平 - 我根本没有时间对源代码进行深入研究，SO上的其他线程提到了twisted's official documentation，其中最多只是补丁，在最坏的情况下缺席，偶尔也会过时。

那里有什么更彻底，更宽容，更实用，或者我是否仍然坚持使用另一种经典，无聊的STFU和RTFM，即使TFM无用？

---

更新

回应JP Calderone的评论，我只是有一个婊子，在某种程度上我猜我是，但我认为问题的广度是有效的考虑到Twisted的广度和价值以及缺乏明显，彻底文档。我有一些想要调查的事情，但是我已经得到了好的结果，只是将事情放在一起，并且当我在寻找更深入，更广泛的理解时，要求具体细节，在我看来，没有帮助

立即浮现在脑海中的对比是Django ......我可以阅读（非常彻底的）Django文档，而不一定知道如何做它可以立即做的一切，但我可​​以很好地概述如何我可能会做我需要做的所有事情，并确切知道时机的确切位置。

Answer 1

我将重复这里的一些回答者所说的话（他们都是好的答案），希望能提供一些有点全面的答案。

1. 虽然所包含的文档在各个地方都不稳定，但the core documentation包含对Twisted中基本概念的几个有用且简要的介绍。特别是，请参阅Using Deferreds，Writing Clients和Writing Servers。
2. 此外，API documentation - 尤其是interface modules中的文档 - 对于随后的每个版本都越来越全面和一致。
3. 如果您对Twisted目标和设计的更高级别描述感兴趣，那么您就知道如何使用I co-authored a paper presented at USENIX 2003来处理其他一些文档Itamar Turner-Trauring。
4. Twisted's FAQ也有点蜿蜒，但可以帮助你解决人们在介绍材料时遇到的许多绊脚石。
5. O'Reilly book about Twisted有一些很好的例子，可以进一步阐明Deferreds和Reactor等核心概念。
当然，
6. Jean-Paul Calderone's "Twisted Web In 60 Seconds" tutorials是对更高级别的twisted.web的一个很好的介绍，但你也会看到很多有用的模式在你所编写的任何应用程序中都可能对你有用。
7. 我已经写了一篇关于Twisted中使用的构建块的文章，deal with the filesystem和load plugins。
8. 最后但当然，Dave Peticolas's modestly titled "Twisted Intro"是一个非常全面的描述，带有图表和轶事，介绍了很多人都有困难的介绍性材料。

请注意，所有新功能都附带新的API（即参考）文档;我们希望这能使具有技术写作技能的人更合理地编写文档，而不必费力去理解方法名称的含义。

Answer 2

Twisted Intro Dave Peticolas是一个惊人的从头开始的Twisted概述。它开始变得简单，然后开始越来越深入，同时解释一切。

我已经使用Twisted多年了，发现这个介绍填补了我所遗漏的所有空白并揭示了整个事情。绝对值得您花时间去看看！

Answer 3

让Jean-Paul Calderone检查Twisted Web in 60 seconds！

但是，老实说，Twisted的官方文档并不完美，但我不会称之为恶心。其中有很多有价值的信息。

Answer 4

看看上一篇文章...

Python twisted: where to start

Answer 5

有O'Reilly的书Twisted Network Programming Essentials。

我还没看过，但ToC看起来还不错。