到如今，我仍然听到有人抱怨 Rails 的文档很糟糕。在我看来，这与事实相差甚远。让我来逐条列出证据

RailsTutorial.org

为了从头开始学习 Rails，Michael Hartl 最近完成了他的著作 Ruby on Rails Tutorial: Learn Rails by Example。此书自始至终地教授 Rails 3，而且 可以**免费**在线阅读。如果您愿意使用PDF 或书籍，您也可以获得（而且作者仍在制作一些 屏幕录像）。

一旦完成，最终书籍的资源就将上传到 GitHub，并在 Rails 3 完成后以知识共享许可证发布。如果您希望将此书翻译成您选择的语言，请随时 联系 Michael，届时他会联系您。

Rails 指南

如果您不是 Rails 新手，请不要忘记用于 Rails 3 的 Rails 指南。

Rails API 文档

我在做 API 查找时使用两个主要的网站。第一个是 Rails 可搜索 API 文档，这其中包含在线和离线可搜索的文档。第二个是 APIdock，它只在线，但能够注释和轻松比较文档的不同版本。

免费的 Rails 3 屏幕录像

如果您更倾向于视觉学习者（如我），那么有不少免费的屏幕录像来教授 Rails 3。大约两个月前，我制作了 Rails 3 屏幕录像，它将帮助您入门。

Ryan Bates 还制作了数量惊人的 Rails 3 屏幕录像，在 Railscasts.com 上。Ryan 制作 Railscasts 已超过 3 年半，这不疯狂吗？

还有 Charles Max Wood 在 Teach me to Code 上制作了一些免费的屏幕录像。

保持领先

如果你发现自己正在思考如何跟上适用于 Rails 3 的所有最新特性/库，那么 Ruby5 Podcast 和 Ruby Show 正在强势发展。不听音频？没关系，只需订阅 Ruby5 RSS 订阅源，然后获取描述所有最新库、教程等的链接。你可能还希望签出 Peter Cooper 的全新 Ruby Weekly，它是一款 Ruby 电子邮件时事通讯</a>。

需要将一款大型应用程序升级到Rails 3？

Jeremy McAnally 的 Rails 3 升级手册 PDF 仅需 12 美元。还可以在 Thinkcode.tv 和 BDDCasts 上找到几个付费的升级屏幕录制。

需要一本手册？

在发布后将推出许多手册，其中大部分你现在都可以开始阅读。Rails 3 the Way，作者 Obie Fernandez；Rails 3 In Action，作者 Ryan Bigg 和 Yehuda Katz；Beginning Rails，作者 Cloves Carneiro Jr 和 Rida Al Barazi；当然还有 Agile Web Development with Rails 的第四版，作者 Sam Ruby、Dave Thomas 和 David Heinemeier Hansson。

总之

不要再抱怨缺乏良好的文档！认真考虑。如果你想要更多 Rails 3 内容，请查看 Kevin Faustino 在 34 Ruby on Rails 3 resources to get you started 上发布的博客内容。