将样式指南放在R包中的位置

时间:2019-02-14 11:37:21

标签: r r-package readme

我目前正在研究基于GitHub的R包,我想添加包含编码样式准则的markdown文本。问题是我找不到放置该信息的最佳位置。根据{{​​3}},我不能只添加STYLE.md文件而不会使软件包无法通过基本的构建检查。他们说:

  

R包的源包含一个子目录,该子目录包含一个   文件Description和NAMESPACE,以及​​子目录R,数据,演示,   exec,inst,man,po,src,测试,工具和小插曲(其中一些   可以丢失,但不能为空)。包装   子目录可能还包含文件INDEX,配置,清理,   许可,许可和新闻。其他文件,例如INSTALL(用于   非标准安装说明),README / README.md或   R将忽略ChangeLog,但对最终用户可能有用。

因此,我当前的解决方案是将样式指南集成到README.md文件中,但我不喜欢将其放在那儿,因为该指南是为软件包提供者而不是用户编写的;它对访问软件包主页的每个人都不可见(这是对用README.md编写并推送到GitHub的任何东西都会发生的情况)。

我想做的另一件事是为此创建一个小插图; rockchalk软件包Writing R Extensions的开发人员。但是,我的指南要短得多,我认为它与小插图的聚光灯和易于打印的格式不太匹配。

我还能/应该在哪里放样式指南?

0 个答案:

没有答案