我与一小部分项目合作,因此缺乏关于希望进行项目开发的软件项目文件层次结构中目录的命名约定的知识。
我查看知名项目(如 Firefox、GCC、binutils、Linux、Emacs、VIM 等)并收集一些常用目录(我自己写的评论,所以它们不会假装是真的……):
examples
或samples
在小脚本或小程序或小配置中展示项目的实际用法。scripts
,support
- 缺少脚本/实用程序的包装器或副本,以提供跨环境构建。tools
- 额外的实用程序来分析或调试项目。contrib
- 用户提供的脚本、配置等...misc
,etc
- 未分类的文件(如果您不知道放置它的正确位置)。config
,extra
-不知道...
虽然src/
、test/
、build/
、dist/
和lib/
其他目录命名约定由 prog-langs/platforms/frameworks 等规定,但此目录似乎对所有类型的项目都很常见。
因此,我寻找包含项目支持文件的目录的命名约定指南(官方或非官方)。
与常规项目文件最重要的区别在于,这些文件不用于项目发布build或在极少数情况下使用。
附言。有人可能会争辩说这不是一个问题。但是我有真正的任务来提交几个脚本(从数据库中转储菜单的 sql 脚本、为 Web 控制器转储 url 映射的脚本等)并查找应该保存这些文件的目录名称......
聚苯乙烯。我收集约定的努力: