Blog

深夜发布说明,不只是更新清单

发布于 2026年3月8日

发布说明的核心任务,不是告诉人“我们做了很多事”,而是帮助读者快速判断:这次更新与我有什么关系,它改变了什么,以及接下来我该做什么。

我更关心三件事

  1. What changed

    描述事实,不要绕弯。

  2. Why now

    说明这次更新出现的时机和背景。

  3. What to do next

    把需要用户采取的动作写得明确。

如果这三件事不完整,发布说明就很容易滑向“任务回执”。那种文本通常写给作者自己,而不是写给要接手变化的人。

深夜里的读者并不需要更多项目符号,他们需要的是一条清楚的线索,知道从哪里开始理解变化。

写作不是复述工作量,而是交付可理解性。
抽象的蓝绿色渐变封面
当页面足够安静时,一张大图只需要承担气氛,而不是信息密度。

MDX 的意义

在这类文章里,MDX 不是为了把页面做得更像海报,而是为了在合适的位置插入更有结构的表达。像 CalloutTimeline 这种组件,能帮助读者在长文中快速重新定位。

const releaseShape = {
  intent: '先说明为什么更新',
  changes: ['核心变化', '兼容影响', '迁移方式'],
  nextStep: '告诉读者接下来做什么',
};

只要组件是克制的,MDX 就能成为内容表达的增强,而不是分散注意力的来源。

Discussion

评论

Giscus 尚未配置。补齐 `.env` 中的 `PUBLIC_GISCUS_*` 变量后,评论区会自动启用。