出现问题的页面的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”会更好理解?
6条答案
按热度按时间w8f9ii691#
它们并不总是包;有时它们是包含更深层次包的目录。我们想不出更好的术语了。
qfe3c7zg2#
重复的#43327?
toiithl63#
技术上,并非所有的树叶都是包,但显示的树的所有叶子都是包,只有包是链接的。非包目录的唯一目的是将包分组。用户界面中的树形组件通常根据目标对象的类型进行命名,而不是结构化对象的类型。
ukxgm1gy4#
看起来该部分的目的是展示模块的包及其包文档,因此“Packages”是有意义的。即使页面上的子目录部分看起来其主要目的是允许导航到子包文档,而不是实际上暴露子"目录"。
hm2xizp95#
这个部分不仅显示了包,还显示了嵌套的模块。例如,https://pkg.go.dev/golang.org/x/tools#section-directories 显示了一个带有
module
标签的 gopls。628mspwn6#
也许将"Directories"部分分成三个单独的部分是有意义的: