在维护 Git 仓库,特别是文档类型的仓库,随着文档数量的增加,很容易出现信息不准确或过时的情况。为了解决这个问题,你可以将文档的内容与对应功能的代码或存在的 issue 绑定,当上游代码发生变化时,自动触发文档的更新。这种方式适合文档项目从 0 到 1 的初期,但是对于已经存在的文档项目重新维护这样的绑定关系就会变得很麻烦。
为了及时发现文档仓库中可能过时的内容,你可以使用 git log
命令获取文档的最后一次更新信息,以发现长期未更新的文档。下面具体介绍如何使用 git log
生成指定目录下所有 Markdown 文件的最后一次 commit 信息。