稳定版本和发行说明为何不匹配?

好的——我一直很好奇这个问题,所以想问问……

我收到来自我们 Discourse 实例的邮件,通知我有一个“新版本”可用。
邮件中包含一个链接:“查看发布说明中的新功能……”
但当我点击该链接时,却找不到关于该新版本的任何信息,也没有相关的发布说明。

请看这里——邮件中说新版本是 2.5.2,但现在看看该链接指向的页面——你看到有关 2.5.2 发布说明的任何内容了吗?

所以,这个链接非但没有帮助我,反而让我感到沮丧。

难道只有我遇到这种情况吗?

1 个赞

2.5.2 版本稳定,改动极小,新版本为测试版。

1 个赞

谢谢——但为了确保我们信息同步……
链接显示会跳转到 2.5.2 版本的发布说明,但实际上并没有。在该链接/页面的任何地方都未提及 2.5.2 版本的发布说明。
上一次公告也出现了同样的问题。

1 个赞

我们通常不为稳定版更新发布说明,因为它们通常只是极其微小的变更,仅包含绝对必要的向后移植的错误修复等。您或许可以通过特殊链接从 GitHub 获取稳定版的变更,@jomaxro 或许有相关建议。

我们一般建议您保持在 tests-passed 分支,我们所有的客户/托管服务都使用 tests-passed。

2 个赞

Jeff 说得对,我不为稳定版发布撰写发布说明。您收到的邮件是标准邮件,由所有 Discourse 实例共享。它并不知道您所在的分支。

稳定版点发布仅包含关键错误修复和安全补丁。与我们通常包含数百项变更的发布不同,稳定版点发布通常少于 10 项变更,很多时候甚至更少。

您可以在 https://github.com/discourse/discourse/commits/stable 查看所有变更。查找“版本更新至 v{当前版本}

5 个赞

明白了。您关于不为稳定版本发布说明的理由有一定道理。我的唯一观点是,我们许多人会收到电子邮件通知,而大多数情况下,发布说明链接里其实没什么内容。一个可行的方案是修改模板,更好地设定预期,而不是让我感到被误导,通常点击后却发现内容与刚收到的邮件无关。

如果这是我们的产品,我会花 10 分钟为每个版本编写发布说明。
只需简单说明:“这是一个小版本更新,风险较低,主要是错误修复。但我们确实改变了 xxx 的处理方式,如果您希望了解这一改进或潜在影响,请注意。”

总之,我没什么意见了。

1 个赞

我建议更新标准版本更新邮件模板:


“查看 发布说明 中的新功能”
改为
“在这些 发布说明 中翻找一下,试着找出这个新版本包含哪些内容,因为该版本并没有对应的发布说明”

背景
今天又收到一封邮件,通知 2.7.1 已发布,并附有发布说明链接,但该链接中并没有 2.7.1 的发布说明。该链接要么应提供有效信息,要么应直接省略。

1 个赞

嘿,Bill,

我们内部讨论了一下。我想你能理解,我们不会按你提议的那样修改文案。虽然我们仍建议网站保持默认的“测试通过”状态,但我们将为未来的稳定版本创建发布说明。请注意,这些说明的详细程度不会像常规发布说明那样高,因为稳定版更新仅包含关键错误修复和安全补丁。

6 个赞

非常好。我为之前的讽刺语气道歉,但每当我收到新版本通知时,我立刻就想点击链接,以了解该版本可能对我的用户产生何种影响,以及升级的优先级有多高等等。
然而,我始终感到沮丧,因为链接往往无法提供这些信息,而且在大多数情况下,升级文档中从未引用相同版本号的资料。因此,我现在不得不决定要投入多少时间去寻找与该版本相关的特定文档。显然,标有“beta”或更早版本号的文档可能与最终发布版本存在显著差异,因此这些文档对我毫无用处。

感谢您推动此事向前发展。

1 个赞

供将来参考,重大稳定版本升级(如 2.5.0)的有效变更日志,是所有以该版本号开头的测试版发布(例如:2.5.0.beta[1,2,3,4,5,6,7])的汇总。我们致力于确保“测试版”版本始终可用,而我们的“稳定”分支更侧重于“无变更”,而非“无缺陷”。

希望补丁版本的发布说明能帮助您消除困惑。

2 个赞

最近两个稳定版补丁的发行说明已发布。

3 个赞