2

虽然Humans.txt有一个很好的设置和信息丰富的网站,解释了它的目的,突出了它的用途,甚至展示了其中的一些,但我在AUTHORS.md上找不到任何类似的细节。

我发现了一条指向 GitHub 存储库“Hulk”的推文,特别是它的一个特性——生成 AUTHORS.md。这就是我好奇的来源,所以我问了作者。甚至他都不确定它与human.txt的确切目的

Google 上搜索仅得到一个与开发人员相关的结果,即一个名为ZakharovviHumansTxtBundle的 GitHub存储库。所有其他结果都与医疗问题有关。同样,在StackOverflowStackExchange上搜索“authors.md”也没有结果。不是一个。相反,查询“humans.txt”会产生很多。

4

2 回答 2

1

我见过的最早的用途,以及我在项目中使用它的原因,是在对新 GNU 项目的建议中:

http://inti.sourceforge.net/tutorial/libinti/autotoolsproject.html

GNU 标准规定有一些文件必须存在于顶级目录中,如果找不到,Automake 将报告错误。输入以下命令来创建这些文件:

$ touch AUTHORS NEWS README ChangeLog

我记得在 90 年代后期在 GNU 软件中看到过这个文件。

.md扩展只是让 GitHub 将其解析为降价。

于 2019-05-01T18:41:14.897 回答
0

起源……不知道。

AUTHORS 文件的目的通常是识别对项目做出重大贡献的个人。这似乎以多种方式完成。此类文件可以识别项目创始人、识别当前的“开发团队”(当前参与项目的个人)、识别过去对项目做出“重大”贡献的人等。

对于某些人来说,第二个目的是通过确认贡献来激励其他人考虑为项目做出贡献(例如,请参阅 opensource.guide中关于这方面的“鼓励”)。

明确声明作者身份通常会赋予版权等合法权利。Google 已经清楚地考虑了这一点(例如,请参阅Google 的开源贡献指南有关指南的额外详细说明)。

随着版本控制系统的广泛使用,在大多数项目中负责源代码各种组件的个人的身份通过 VCS 元数据在非常精细的级别上非常清晰地建立起来。因此,现在可能不太需要将作者姓名添加到各个源文件的标题中。这可能与上面提到的第二个目的相关:例如,(a) 对“唯一所有权”的看法可能会阻碍协作,并且 (b) 如果不鼓励将作者信息放入头文件中,则 AUTHORS 文件建立了一种明确给予信用的方法。给定的项目。

于 2019-05-01T18:31:43.723 回答