本文档旨在介绍您在贡献文档时可能会看到的奇怪之处,因为其中的工具用于管理在 Google 内部代码库中来回复制源代码。此工具称为 Copybara。
内部可信来源
由于此代码库中代码的可靠来源是 Google 的内部代码库,因此每当导入和导出代码时,Copybara 都会对代码进行转换。这意味着,有时看似正常的更改可能会在内部以令人惊讶的方式中断。
PR 合并状态和 diff 不一致
由于可信数据来源是内部数据,因此 PR 不会直接合并,因此它们会导入到 Google 内部仓库中,在其中接受额外的测试,然后提交该内部更改,并归因于 PR 作者。由于 Copybara 执行的转换,无法保证差异完全相同(例如,Copybara 在导入时应用格式)。
因此,Copybara 不会将 PR 标记为已合并,而是会关闭 PR 并单独应用一个应该与 PR 非常贴近的提交。
对 TSL 的依赖性(按文案)
如当前所实现的那样,为了防止任何临时损坏的提交,XLA 依赖于 TSL,而不是通过使用 Bazel 的 http_archive
下载副本,而是让 Copybara 将 TSL 复制到 XLA 的 third_party
目录中。