Blog
深夜发布说明,不只是更新清单
发布说明的核心任务,不是告诉人“我们做了很多事”,而是帮助读者快速判断:这次更新与我有什么关系,它改变了什么,以及接下来我该做什么。
我更关心三件事
- What changed
描述事实,不要绕弯。
- Why now
说明这次更新出现的时机和背景。
- What to do next
把需要用户采取的动作写得明确。
如果这三件事不完整,发布说明就很容易滑向“任务回执”。那种文本通常写给作者自己,而不是写给要接手变化的人。
深夜里的读者并不需要更多项目符号,他们需要的是一条清楚的线索,知道从哪里开始理解变化。
MDX 的意义
在这类文章里,MDX 不是为了把页面做得更像海报,而是为了在合适的位置插入更有结构的表达。像 Callout、Timeline 这种组件,能帮助读者在长文中快速重新定位。
const releaseShape = {
intent: '先说明为什么更新',
changes: ['核心变化', '兼容影响', '迁移方式'],
nextStep: '告诉读者接下来做什么',
};
只要组件是克制的,MDX 就能成为内容表达的增强,而不是分散注意力的来源。
Discussion
评论
Giscus 尚未配置。补齐 `.env` 中的 `PUBLIC_GISCUS_*` 变量后,评论区会自动启用。