x/pkgsite:为什么pkg.golang.org在提到"目录"时,Go更常用术语"包"?

ruarlubt  于 2个月前  发布在  Go
关注(0)|答案(6)|浏览(27)

出现问题的页面的URL是什么?

(示例) https://pkg.go.dev/net/http

你的user agent是什么?

Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/89.0.4389.114 Safari/537.36

截图

你做了什么?

访问pkg.golang.org查看包/模块文档。

你期望看到什么?

在左侧菜单中,有一个名为“Packages”的链接,指向模块的包文档。

你看到了什么?

它没有称其为“packages”,而是称之为“Directories”。Go通常将其称为“packages”。“Directories”给人一种浏览源文件的印象。即使摘要描述都说“Package xyz implements ...”,因为规则是文档要说“Package xyz...”,但UI上却显示为

Directories

cgi
   Package cgi implements CGI (Common Gateway Interface) as specified in RFC 3875.

cookiejar
   Package cookiejar implements an in-memory RFC 6265-compliant http.CookieJar.

是否应该改为“Packages”会更好理解?

w8f9ii69

w8f9ii691#

它们并不总是包;有时它们是包含更深层次包的目录。我们想不出更好的术语了。

toiithl6

toiithl63#

技术上,并非所有的树叶都是包,但显示的树的所有叶子都是包,只有包是链接的。非包目录的唯一目的是将包分组。用户界面中的树形组件通常根据目标对象的类型进行命名,而不是结构化对象的类型。

ukxgm1gy

ukxgm1gy4#

看起来该部分的目的是展示模块的包及其包文档,因此“Packages”是有意义的。即使页面上的子目录部分看起来其主要目的是允许导航到子包文档,而不是实际上暴露子"目录"。

hm2xizp9

hm2xizp95#

这个部分不仅显示了包,还显示了嵌套的模块。例如,https://pkg.go.dev/golang.org/x/tools#section-directories 显示了一个带有 module 标签的 gopls。

628mspwn

628mspwn6#

也许将"Directories"部分分成三个单独的部分是有意义的:

  • Packages
  • Commands
  • 嵌套模块

相关问题