虽然 Humans.txt 有一个非常好的设置和信息性website解释其目的,突出其用途,甚至展示其中的一些,我找不到任何类似的细节 AUTHORS.md
我发现一个tweet指向一个GitHub回购,“绿巨人”,特别是它的一个特征 - generating an AUTHORS.md。这是我好奇心的来源,所以我向作者询问了这件事。他甚至不确定its exact purpose vs. that of humans.txt。
search on Google只产生了一个与开发人员相关的结果,一个名为ZakharovviHumansTxtBundle的GitHub仓库。所有其他结果都与医疗问题有关。 同样,在StackOverflow和StackExchange上搜索“authors.md”会产生 no 结果。不是一个。相反,查询"humans.txt"会产生很多。
答案 0 :(得分:0)
起源...不知道。
AUTHORS文件的目的通常是确定对项目做出了重大贡献的个人。这似乎可以通过多种方式完成。这样的文件可以标识项目创建者,标识当前的“开发团队”(当前从事该项目的个人),标识过去对该项目做出“重大”贡献的人,等等。
对于某些人来说,第二个目的是通过认捐,激励其他人考虑为该项目做出贡献(例如,参见“鼓励” opensource.guide。
明确声明作者身份通常会授予诸如版权之类的合法权利。 Google对此已经清楚地考虑了一下(例如,参见Google's open source contributions guidelines和additional elaboration on the guidelines)。
随着版本控制系统的广泛使用,在大多数项目中,通过VCS元数据非常清楚地建立了负责源代码各个组件的个人的身份。因此,现在不太可能需要将作者姓名添加到各个源文件的标头中。这可能与上面提到的第二个目的相关:例如,(a)认为“唯一所有权”可能会阻碍协作,并且(b)如果不鼓励将作者信息放入标头文件中,则AUTHORS文件建立了一种清晰地表示感谢的方式。给定的项目。
答案 1 :(得分:0)
我见过的最早的用法,以及我将其用于我的项目的原因,是在新GNU项目的建议中:
http://inti.sourceforge.net/tutorial/libinti/autotoolsproject.html
GNU标准说有一些文件必须存在于顶层目录中,如果找不到,Automake将报告错误。输入以下命令来创建这些文件:
$ touch AUTHORS NEWS README ChangeLog
我记得90年代后期在GNU软件中看到过这个文件。
.md
扩展名只是让GitHub将其解析为markdown。