有没有比官方网站更全面、深入的Twisted文档？
我最近在研究Twisted这个东西，感觉挺有意思的——写服务器的时候好像能发挥很大的能力。不过，尽管我用twisted.web写过几个网页服务器（主要是看别人的代码和一本很老的O'Reilly书），我始终觉得自己和Twisted之间没有建立起一种亲密的关系……也就是没有真正理解它，没能掌握它看起来拥有的那些强大功能。
我觉得我需要一些好的文档来提高自己的理解水平——我实在没时间去仔细研究源代码，其他人在Stack Overflow上提到过Twisted的官方文档，但那文档要么不完整，要么根本没有，有时候甚至非常过时。
有没有其他更全面、更友好、更实用的资料呢？还是说我只能接受那种经典又无聊的“闭嘴，去读手册”的说法，尽管手册根本没什么帮助？
更新
针对JP Calderone的评论，我承认我有点在抱怨，但我觉得这个问题的广泛性是合理的，因为Twisted的范围和价值都很大，而明显的、全面的文档却缺乏。我有一些想要研究的内容，但我现在只是拼凑东西，问一些具体的问题，而我真正想要的是更深入、更全面的理解，这样的方式在我看来并没有帮助。
我脑海中立刻想到的对比是Django……我可以仔细阅读（非常全面的）Django文档，虽然不一定能立刻知道怎么做所有事情，但我能很好地了解我需要怎么做，并且知道到时候该去哪里找资料。
5 个回答
看看Jean-Paul Calderone写的《60秒了解Twisted Web》吧！
不过说实话，Twisted的官方文档并不是特别完美，但我不会说它糟糕。里面有很多有用的信息。
Dave Peticolas写的Twisted Intro是一个非常棒的关于Twisted的入门介绍。它从简单的内容开始，然后逐步深入，详细解释每一个概念。
我已经使用Twisted很多年了，这个入门教程帮我填补了很多我之前不明白的地方，让我对整个内容有了更清晰的认识。绝对值得花时间去看看！
我想重复一下这里一些回答者说过的话（他们的回答都很好），希望能提供一个比较全面的回答。
- 虽然附带的文档有些地方不太完整，但核心文档里有几个简短而有用的介绍，帮助你理解Twisted的基本概念。特别是，可以看看使用Deferreds、编写客户端和编写服务器。
- 另外，API文档，尤其是接口模块的文档，随着每次更新变得越来越详细和清晰。
- 如果你想了解Twisted的目标和设计的更高层次描述，以便更好地理解其他文档，可以看看我和Itamar Turner-Trauring共同撰写的一篇论文，这篇论文在USENIX 2003上发表。
- Twisted的常见问题解答虽然有点绕，但可以帮助你解决很多人在学习入门材料时遇到的障碍。
- O'Reilly出版的关于Twisted的书里有一些很好的例子，可以进一步阐明像Deferreds和Reactor这样的核心概念。
- Jean-Paul Calderone的“60秒了解Twisted Web”教程是一个很好的入门，虽然它主要讲的是稍微高级一点的twisted.web，但你会看到很多有用的模式，这些模式在你写的任何应用中都可能会用到。
- 我写过一对关于Twisted中使用的构建块的文章，分别是处理文件系统和加载插件。
- 最后但绝对不是最不重要的，Dave Peticolas的“Twisted Intro”标题虽然谦虚，但内容非常全面，包含图示和故事，讲解了很多人觉得困难的入门材料。
请注意，所有新功能都会附带新的API（即参考）文档；我们希望这能让具备技术写作能力的人更容易编写文档，而不必费力理解方法名称的含义。