Ruby核心文档质量

前端之家收集整理的这篇文章主要介绍了Ruby核心文档质量前端之家小编觉得挺不错的,现在分享给大家,也给大家做个参考。
我比较新的 Ruby,有限的时间,所以我尝试简单的事情.
最近我需要创建一个文件,因为我很懒惰,我跑到Google.结果:
File.open(local_filename,'w') {|f| f.write(doc) }

羞于我,这很简单,应该自己做了.然后我想检查File类的方法提供的ruby魔法,或者在调用这些方法时有什么’简化’,所以我去了文档here,并检查File类.

> 1.8.6文档在“File”类中提供了“ftools.rb:File类的额外工具”,这不是我要找的.
> 1.8.7文档似乎可以为’File’类,有很多方法.除了’开放’.
> 1.9文档最后显示了我的’开放’方法.

和Net :: HTTP几乎相同的旅程.

当我认为旧的Turbo Pascal 7.0文档比Ruby文档更好组织时,我夸张吗?有没有其他来源来收集知识?还是有可能我只是沉迷于一个文件孔,其余的是超级辉煌的五星级组织?

谢谢

解决方法

你必须记住,Ruby是一种面向对象的语言,标准库中的很多对象都是建立在其他对象之上的.另外还有许多是通过模块扩展的,这增加了新的功能.

因此,在文档中,您需要查看Object的内容.在File的情况下,它建立在IO之上,它将具有很多您期望在标准“文件”类中找到的功能.

我同意Ruby的一些文档是脱节的.我认为获得好书很重要我推荐我们称之为“镐书”,AKA“Programming Ruby”.还有很多其他好书,还有一些很好的文档,但这是一本很棒的书. [第一版]可免费上网;这有点过时,但仍然有用.

我建议您浏览some of the other questions similar to this,以获得更多建议.

我还保持链接开放给Ruby 1.9的CoreKeyword文档.而且,最后,Ruby-Docs site的顶部还提供了很多很好的信息,但您必须注意该文档的版本.

最后,不要忽视内置的帮助:在命令行中,ri是您自己的机器上的一个快速的信息源,应该包含核心和标准库的文档以及您安装的所有gem. ri打开会告诉你所有的地方“开放”被定义. ri File.open会给你很多有关该命令的信息.

当我开始使用Ruby时,学习语言的最大障碍就是文档.我仍然觉得获得PerlPython的信息要容易得多,感觉Ruby应该以这些为例.这不会改变我对使用Ruby的乐趣.这是一种伟大的语言,一旦越过了初始的驼峰,我越来越喜欢它.

@ypffer在上面的评论中建议使用RubyDoc.info.我没看过这个网站,但看起来不错.我喜欢它显示了一个类从什么继承而来.

猜你在找的Ruby相关文章