发布技术文章前的简明检查清单

发布检查清单应该足够简短,才能每次都用起来。我会问自己五个问题:

  1. 开篇是否清楚说明了问题,不需要读者先看一大段背景?
  2. 命令和代码示例是否仍然可以运行?
  3. 外部事实是否链接到了原始来源?
  4. 每张有信息价值的图片是否都有清楚的替代文本?
  5. 生产构建是否能在没有警告的情况下完成?

对于 Hugo 站点,最后一步可以很简单:

hugo --panicOnWarning --minify

在窄屏和宽屏视口下都预览生成的网站。长标题、表格、代码块和导航标签,比占位文字更容易暴露布局假设。

清单不是为了走形式,而是把反复出现的错误从记忆中移到流程里,让忙碌时也能稳定发布。