O objetivo deste documento é descrever peculiaridades que você pode encontrar ao contribuir devido à ferramenta que gerencia a cópia de origem do repositório interno do Google. Essa ferramenta é chamada de Copybara.
Fonte interna da verdade
Como a fonte da verdade do código nesse repositório é o repositório interno do Google, o Copybara faz transformações no código sempre que ele é importado e exportado. Isso significa que, às vezes, mudanças aparentemente normais podem ocorrer internamente de maneiras surpreendentes.
Status da fusão de RP e inconsistências de diferenças
Como a fonte de verdade é interna, as PRs não são mescladas diretamente. Elas são importadas para o repositório interno do Google em que passam por mais testes. Depois, essa mudança interna é enviada e atribuída ao autor da RP. Devido às transformações aplicadas à Copybara, não há garantia de que a comparação será idêntica (por exemplo, a Copybara aplica formatação na importação).
Por esse motivo, o Copybara não marcará o PR como mesclado, ele o fechará e aplicará separadamente uma confirmação que precisa mapear muito de perto com o PR.
Dependência do TSL por cópia
Conforme implementado atualmente, para evitar confirmações temporárias temporárias, o XLA
depende do TSL não fazendo o download de uma cópia usando o http_archive
do Bazel, mas
fazendo o Copybara copiar o TSL para o diretório third_party
do XLA.