戈多克斯。一年后

2022-02-18 22:41:34

它';我们成立godocs已经一年多了。伊奥。对于那些不知情的人,戈多克。io是现已不复存在的godoc的分支。为Go软件包提供文档的组织。一些用户可能更喜欢godocs。io的轻量级页面、更简单的用户界面、更低的资源消耗,或者无论项目许可证如何都能呈现文档。我很高兴宣布第1版。gddo的0,这是一个为它提供动力的软件。自从分叉以来,我们';我做了很多改进。因此,gddo现在支持:

一路上我们';我们删除了超过9500行的Go代码,使Codebase下降到6000行左右。我们邀请您自己制作一个gddo实例,或者查看godocs的hostedinstance。伊奥。

我';我想特别提醒大家注意伪造元标签。这些标签是GoDocs使用的。io链接到模块源代码。与它们所取代的go源代码元标记相比,它们有一些优势,主要的一点是它们与go模块一起工作,因为它们允许链接到特定版本的代码(或Git术语中的引用)。它们也与特定的编程语言无关。

获取Go模块(例如example.org/project)的文档时,godocs。io将向该站点发出HTTP请求,并查找伪造的元标记。这些标签已添加到SourceHut';s Git和Mercurial服务。我们希望鼓励其他锻造厂也采用这些标签。

如果你操作一个软件锻造,或者有一个虚荣导入路径,只需在你网站上的每个项目页面上添加以下标签(确保调整URL以适应锻造/项目):

您可能还想添加以下VCS元标记,它们类似于go import元标记,但不绑定到特定语言:1

godocs目前没有使用这些工具。io,但它们可能会在未来使用。  ↩︎