按文档操作,命令跑不通。因为版本升级,参数变了。

这类问题比没文档更浪费时间:至少没文档时你会去查官方最新,有文档你会信任它。

改进:

  1. 文档顶部标注适用版本和更新日期
  2. 关键命令加版本检查
  3. 定期验证文档可执行性

第三条最有效但最麻烦。我的做法是每季度挑三份核心文档实际跑一遍。

现在所有文档第一行都写:适用于 vX.Y,更新于 YYYY-MM。

主楼