R包数据集文档是否需与use_data_raw及data-raw目录内文件同名？

1. R包中数据集文档是否应与use_data_raw目录下的文件同名？ #

• 没有强制要求必须同名，但推荐保持命名关联，这会极大提升包的可维护性。
• use_data_raw（通常简写为data-raw）目录下的文件是用于生成数据集的预处理脚本（比如数据清洗、导入、转换的代码），而数据集文档是放在R目录下、用roxygen2注释编写的对应data目录中数据集的说明文档。
• 举个直观的例子：如果data-raw里的脚本是prepare_customer_data.R，生成的数据集是customer_data，那把文档放在R/customer_data.R里，任何人看代码都能立刻对应上这个数据集的生成逻辑和说明文档，避免混乱。当然你也可以把多个数据集的文档合并到同一个R文件中，但分开对应会更清晰。

2. 数据集文档需存放于R目录的.R文件中，data-raw目录也包含.R文件，二者是否需完全同名？ #

• 同样没有强制的完全同名要求，但遵循一致的命名逻辑是行业惯例。
• 比如如果data-raw里的process_survey_responses.R脚本生成了survey_summary和survey_details两个数据集，你可以选择：
  • 分别创建R/survey_summary.R和R/survey_details.R来对应每个数据集的文档；
  • 也可以把两个数据集的文档都放在R/survey_responses.R里，只要在roxygen注释中明确标注每个数据集的信息即可。
• 核心原则是：让后续维护者（包括未来的你）能快速找到某个数据集的生成脚本和对应的说明文档，命名一致性是实现这一点的最简单方式。

内容的提问来源于stack exchange，提问作者xhr489