Markdown AUTHORS.md的起源和目的是什么?

Markdown AUTHORS.md的起源和目的是什么?,markdown,human-readable,Markdown,Human Readable,虽然Humans.txt有一个非常好的设置和丰富的信息来解释它的用途,强调它的用途,甚至展示其中的一些,但我在AUTHORS.md上找不到任何类似的细节 我发现了一个指向GitHub回购协议的链接,“绿巨人”,特别是它的一个特性-。这是我好奇心的来源,所以我问了作者。甚至他也不确定 A只产生了一个与开发人员相关的结果,一个名为GitHub的repo。所有其他结果都与医学问题有关。 类似地,在两个和上搜索“authors.md”都不会产生任何结果。一个也没有。相反,查询会产生许多。来源。。。不知道

虽然Humans.txt有一个非常好的设置和丰富的信息来解释它的用途,强调它的用途,甚至展示其中的一些,但我在AUTHORS.md上找不到任何类似的细节

我发现了一个指向GitHub回购协议的链接,“绿巨人”,特别是它的一个特性-。这是我好奇心的来源,所以我问了作者。甚至他也不确定

A只产生了一个与开发人员相关的结果,一个名为GitHub的repo。所有其他结果都与医学问题有关。 类似地,在两个和上搜索“authors.md”都不会产生任何结果。一个也没有。相反,查询会产生许多。

来源。。。不知道

作者档案的目的通常是确定对项目做出重大贡献的个人。这似乎是通过多种方式实现的。这些文件可以确定项目创始人,确定当前的“开发团队”(当前参与项目的个人),确定过去对项目做出“重大”贡献的人,等等

第二个目的,对于一些人来说,是通过承认贡献,激励其他人考虑为项目做出贡献(例如,看到“鼓励”)。 在这方面)

明确的作者身份声明通常会授予版权等法律权利。谷歌显然已经考虑过这一点(例如,请参阅和)


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

这是我见过的最早的用法,我之所以在我的项目中使用它,是因为对新GNU项目的建议:

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

$touch作者新闻自述更改日志

我记得上世纪90年代末在GNU软件中看到过这个文件


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

注意:我本来会创建标记[[humans.txt]]和[[authors.md]],但缺少足够的重复。请注意,如果只有一个问题,可能不应该创建标记。谢谢。不过很奇怪。不这样做的原因是什么(除了可能被滥用)标签用于快速查看问题内容并搜索特定主题。一个唯一的标签对于这两个方面来说都太特殊了。搜索它会直接把你带到这里,所以没有什么意义。事实上,你找不到它的细节,这表明大多数人可能不知道它是什么,但如果他们知道,他们会在问题标题中找到它。人们通常只使用一个标签,如果是这样的话,问题就不那么明显了。这是有道理的。只要搜索算法是强大和智能的——我确信它们是在堆栈交换上的。