Go 博客

Pkg.go.dev 焕新登场!

邱Julie
2020 年 11 月 10 日

自从推出 pkg.go.dev 以来,我们收到了很多关于设计和可用性的宝贵反馈。特别是,信息组织方式在用户浏览网站时造成了困惑,这一点非常明显。

今天,我们很高兴与大家分享重新设计的 pkg.go.dev,我们希望它能更清晰、更有帮助。这篇博文介绍了亮点。有关详细信息,请参阅 Go issue 41585

所有路径一致的登陆页面

主要变化是 pkg.go.dev/ 页面已围绕路径的概念进行了重新组织。路径表示模块特定版本中的目录。现在,无论该目录中有什么内容,每个路径页面都将具有相同的布局,目的是使体验始终有用且可预测。

Landing page for cloud.google.com/go/storage
图 1. https://pkg.go.dev/cloud.google.com/go/storage 的登陆页面。

如果存在 README,则路径页面将显示该路径下的 README。以前,“概述”选项卡仅在模块根目录存在 README 时才显示它。这是我们为将最重要信息置于首位而进行的众多更改之一。

文档导航

文档部分现在显示索引以及侧边栏。这使得能够查看完整的包 API,并在浏览文档部分时拥有上下文。左侧侧边栏中还有一个新的“跳转到”输入框,用于搜索标识符。

Jump To feature navigating net/http
图 2. https://pkg.go.dev/net/http 上的“跳转到”功能。

有关文档部分更改的详细信息,请参阅 Go issue 41587

主页上的元数据

每个页面顶部的栏现在显示其他元数据,例如每个包的“导入”和“被导入”计数。横幅还会显示有关模块最新次要版本和主要版本的信息。有关详细信息,请参阅 Go issue 41588

Header metadata for github.com/russross/blackfriday
图 3. https://pkg.go.dev/github.com/russross/blackfriday 的标题元数据。

视频演练

上周在 Google 开源直播 上,我们在我们的演讲《提升水平:Go 包发现和编辑器工具》中介绍了新网站体验的演练。

反馈

我们很高兴与您分享此更新的设计。与往常一样,请通过每个页面底部的“分享反馈”和“报告问题”链接告诉我们您的想法。

如果您有兴趣参与此项目,pkg.go.dev 是开源的!查看 贡献指南 以了解更多信息。

下一篇文章:Go 十一年
上一篇文章:宣布 2020 年 Go 开发者调查
博客索引