是否有可能/建议跳过roxygen以支持roxygen2？

Question

我最近被指向Roxygen解决我的文档困境/懒惰.但是在这个闪亮的Roxygen2中,根据我的理解,它有点像它自己的东西.Hadley的包装工具需要使用Roxygen2,但在任何地方都没有通过走路的方式.

鉴于我在学习过程中从头开始:

1. 是否有一个用户,对于新用户,有利于Roxygen而不是Roxygen2,或者Roxygen2在所有方面都更好？

2. 如果有的话,有哪些资源用于学习(最好是那些不依赖于Roxygen先前知识的资源)？

3. Roxygen2是否与Roxygen向后兼容(这样投入学习和写作Roxygen的时间会延续下去)？

Answer 1

如果从头开始,没有理由喜欢roxygen到roxygen2.我们正在为r新闻撰写介绍性文章.

Answer 2

我切换我的构建脚本来调用roxygen2而不是roxygen,一切都像以前一样工作,除了现在我得到了一个漂亮的,自动生成的NAMESPACE文件.

所以学习roxygen意味着你正在学习roxygen2的基础知识.我确定我没有使用所有新功能,但对于基础知识,roxygen2就像roxygen一样.

我还补充说install_github(),在devtools包中(也在github上)绝对是好的.对于非CRAN值的软件包,github是一个很好的方法.