2010年8月28日,星期六

Rails文档很棒

发布者:Gregg Pollack

至今我仍然听到人们抱怨Rails的文档很差。在我看来,这似乎与事实相去甚远。让我一项一项地拿出证据来


RailsTutorial.org

为了从零开始学习Rails,Michael Hartl最近完成了他的书《Ruby on Rails Tutorial: Learn Rails by Example》。这本书从头开始教授Rails 3,并且可在网上免费阅读。如果您更喜欢PDF实体书,也可以购买(他还在制作一些屏幕录像)。

最终书籍的源代码将在Rails 3完成后不久推送到GitHub并以知识共享许可协议发布。如果您想帮助将这本书翻译成您选择的语言,请随时联系Michael,届时他会与您联系。

Rails Guides

如果您不是Rails新手,请不要忘记Rails Guides,它已针对Rails 3进行了更新。

Rails API 文档

我有两个主要的网站用于进行API查询。第一个是Rails Searchable API Doc,它提供了在线和离线可搜索的文档。第二个是APIdock,它仅在线,但具有评论和轻松比较不同版本文档的功能。

Rails 3 免费屏幕录像

如果您更喜欢视觉化学习(像我一样),那么有很多免费的屏幕录像可以教您有关Rails 3的知识。大约2个月前,我制作了Rails 3 Screencasts,可以帮助您入门。

Ryan Bates还在Railscasts.com上制作了大量的Rails 3屏幕录像。Ryan制作Railscasts已经超过3年半了,是不是很疯狂?

Charles Max Wood在Teach me to Code上也提供了一些不错的免费屏幕录像。

跟上最新动态

如果您想知道如何跟上Rails 3所有最新的功能/库,那么Ruby5 PodcastRuby Show都在蓬勃发展。不听音频?没关系,只需订阅Ruby5 RSS feed即可获取最新库、教程等的链接和描述。您可能还想查看Peter Cooper的新的Ruby Weekly,这是一个Ruby电子邮件通讯。

需要将大型应用升级到Rails 3?

Jeremy McAnally的Rails 3 Upgrade Handbook PDF只需12美元。在Thinkcode.tvBDDCasts上还有一些付费的升级屏幕录像。

需要一本书?

发布后将有许多书籍问世,其中大部分您现在就可以开始阅读了。Obie Fernandez的《The Rails 3 Way》,Ryan Bigg和Yehuda Katz的《Rails 3 In Action》,Cloves Carneiro Jr和Rida Al Barazi的《Beginning Rails》,当然还有Sam Ruby、Dave Thomas和David Heinemeier Hansson的第四版《Agile Web Development with Rails》。

总之

不要再抱怨缺乏好的文档了!认真点。如果您想要更多Rails 3的内容,请查看Kevin Faustino关于34个Ruby on Rails 3资源助您入门的博文。