技术

发布之前,一份很短的检查清单

从正文到链接,从键盘到窄屏,检查那些读者会真实碰到的小问题。

本文目录

这份清单用在发布之前,按顺序走一遍,通常几分钟。它检查的不是代码风格,而是读者会真实碰到的东西:读得下去、拿得到内容、键盘走得通。

内容检查

  • 标题和摘要是否明确?
  • 代码是否能被完整复制?
  • 图片是否有准确的替代文本?
  • 引用是否交代来源?

页面检查

用键盘走一遍导航。缩窄窗口,检查表格与代码。切换深色模式,确认强调文字仍然清楚。

发布后

确认站点域名、RSS 与分享信息已经更新。保留可重复执行的自动化检查,让下一次发布也同样安心。

为什么不做成自动检查

上面大部分条目机器判断不了。「摘要是否明确」和「替代文本是否准确」需要有人真的读一遍,所以它们留在这里,而不是写进测试。能自动化的部分——链接是否可达、类型是否正确、格式是否统一——已经交给 pnpm verify,清单里就不再重复。

搜索