go x/website:在下载页面上包含发布日期

lokaqttq  于 1个月前  发布在  Go
关注(0)|答案(8)|浏览(38)

如果发布版本中也包含发布日期,那就太好了。我记不清是1.15rc1还是beta1重新构建了AMI,但如果发布日期出现在下载页面上,我就能做到这一点。

bakd9h0s

bakd9h0s1#

@broady,看起来我们已经在internal/history/release.go中包含了这些信息,我很乐意尝试在DL页面上包含它们,但是DL页面似乎将memcache和cloud datastore作为硬依赖项,我不确定如何在当地引导memcache或cloud datastore;它们看起来没有文档吗?

wfypjpf4

wfypjpf42#

https://golang.org/cl/254538提到了这个问题:internal/dl: add release dates to dl page

r1wp621o

r1wp621o3#

从CL复制的评论:
以下是页面添加内容的截图。

这在我看来与golang.org网站的其他设计有些不一致。这不是一个完整的英语句子。
如果我们要做这个,我建议我们考虑将日期放在页眉中,类似于在release history页面上所做的那样:

另一种可以考虑的选择是包含一个段落,说明发布日期并描述发布(使用来自./internal/history包的信息),如下所示:

然而,我不确定这是改进。它从发布历史页面复制信息,而这些信息已经存在了。下载页面似乎应该更关注下载,而不是重复发布历史页面上的内容。
我对页眉中的日期持开放态度,但鉴于the change的复杂性和大小,我希望首先看到更多关于为什么这对用户来说是个好变化的论据。你能详细说明为什么参考release history页面不起作用吗?谢谢。
@andybons 你对此有何看法?

fbcarpbf

fbcarpbf4#

这不是一个完整的英语句子。
解决这个问题的一个中间方案可以是:
"Go {{.V}} 于 {{.Date}} 发布。查看 Release History 以获取更多信息。"

knsnq2tg

knsnq2tg5#

我在问题描述中回答了为什么这是一个对用户有利的改变。我试图回答这个问题:“我是否在生产环境中运行了最新的Go版本?”我知道我上次重建AMI或deb包的时间,而且我知道我总是发布最新版本。我不知道最近的Go版本是什么时候发布的。

  1. 发布历史页面的信息层次结构使得很难挑选出:
    a) 最近的发布
    b) 最近发布日期

以下是整个发布历史页面的截图;我在页面上为最近发布的发布日期信息做了下划线。它位于页面折叠下方,在一个句子的中间,三个段落下面有一个子标题。

与提议的DL页面位置相比——单独放在一行,位于页面上方,明显的放置位置。DL页面也会获得更多的流量。

  1. 发布历史页面不包含任何关于beta或发布候选版本的信息,因此无法确定betas或RC何时发布。
    有关此主题的更多信息请参阅 How Users Read on the Internet (提示:他们没有)或我关于如何为不阅读的人编写文档的演讲。 https://www.youtube.com/watch?v=sQP_hUNCrcE
    我认为将其放在蓝色标题栏旁边的版本号旁边并不是理想的选择,因为这使得版本号更难扫描,将其放在左手边的行上使得用户在扫描时更容易错过它,“September”这个词比YYYY/MM/DD格式的日期更容易扫描,而且蓝色标题栏中的太多文本使其看起来像横幅广告,这也使得用户在扫描时容易错过它。但是如果那是唯一可以放的地方,那么我们当然可以把它放在那里。
    我理解这个改变很大,但它也有一些好处。它之前与memcache和Google Cloud紧密耦合。移除这种紧密耦合使得添加页面渲染的测试成为可能,同时也使得查看和测试本地更改变得更加容易。
    我可以将这个提交为两个单独的CL,一个移除紧密耦合,另一个实际更新页面。但是为了真正弄清楚我所做的更改将如何进行样式化,有必要移除这种耦合。
jdg4fx2g

jdg4fx2g6#

你好,我在这里跟进一下。
我看到你给了个表情符号“赞”,但我不确定你给的是“赞”什么——CL,将它分成两个CL的建议,以及为什么我认为这是一个好的变化的解释......

q7solyqu

q7solyqu7#

我👍的React是表示我认为这是一个很好的解释,说明为什么我们应该做出这个好的改变。
我相信在https://golang.org/dl/页面添加发布日期是值得做的,即使这个信息可以在发布历史页面上找到,因为你详细阐述了理由。让我们就它应该看起来如何达成一致。
我的担忧是,就我所知,目前的设计看起来与其他网站的元素不同(由于字体较小、不完整的句子、使用不同的日期格式)。请让我知道是否错过了一些您用作参考的页面。否则,您是否同意尝试获得与golang.org网站其他部分更一致的东西?我在上面的评论中提出了一些建议。

mlnl4t2r

mlnl4t2r8#

好的,我已经更新了CL以纳入建议的更改。

相关问题