为何Read the Docs关联GitHub时需授权写入提交状态？

在关联GitHub账号时，Read the Docs要求的权限是：

该应用可读写提交状态（无直接代码访问权限）

这个权限的核心作用是实现文档构建与GitHub提交的状态联动，具体原因如下：

• 同步构建状态到GitHub：当Read the Docs处理你的文档构建请求时，会把构建的实时状态（比如「构建中」「成功」「失败」）更新到对应GitHub提交的状态里。你在GitHub仓库的提交记录页面就能直接看到文档构建结果，不用额外切换到Read the Docs后台查看。
• 支撑自动构建的逻辑：如果开启了「代码提交后自动构建文档」的功能，Read the Docs需要读取GitHub的提交状态来确认代码推送完成，避免在代码还没同步好的时候就触发构建；构建完成后也需要更新状态，标记这次提交对应的文档已经处理完毕。
• 无代码修改风险：权限说明里明确标注了「无直接代码访问权限」，这个权限只能修改提交状态这类元数据，完全不会触及你仓库里的代码、文件或者仓库设置，不用担心代码被篡改。

内容的提问来源于stack exchange，提问作者mtanti