الغرض من هذه الوثيقة هو وصف الحالات الغريبة التي قد تراها أثناء المساهمة بسبب الأداة التي تدير نسخ المصدر ذهابًا وإيابًا من مستودع Google الداخلي. تُسمى هذه الأداة Copybara.
مصدر داخلي للحقيقة
ولأنّ مصدر الحقيقة في هذا المستودع هو مستودع Google الداخلي، تُجري Copybara تحويلات إلى الرمز البرمجي كلما تم استيراد الرمز وتصديرها. هذا يعني أن التغييرات التي تبدو طبيعية في بعض الأحيان يمكن أن تتعطل داخليًا بطرق مدهشة.
حالة دمج العلاقات العامة وعدم الاتساق
وبما أنّ مصدر الحقيقة هو داخلي، لا يتم دمج الردود العامة بشكل مباشر، بل يتم استيرادها إلى مستودع Google الداخلي حيث يخضعان لاختبار إضافي، ثم يتم إرسال هذا التغيير الداخلي، ويُنسب إلى مؤلف العلاقات العامة. وبسبب التغييرات التي تطبّقها أداة Copybara، ما مِن ضمانة بأنّ الفرق سيكون متطابقًا (على سبيل المثال، تُطبِّق شركة Copybara التنسيق عند الاستيراد).
لهذا السبب، لن يضع Copybara علامة على "قاعدة البيانات" على أنّها مدمجة، بل ستغلق "قسم العلاقات العامة" (PR) ويطبّق بشكل منفصل التزامًا يجب ربطه بشكل قريب جدًا بـ "قسم العلاقات العامة".
الاعتماد على TSL حسب النسخة
وفقًا لما هو مُطبّق حاليًا، لمنع أي عمليات تنفيذ معطّلة مؤقتة، تعتمد XLA على عملية TSL، وليس عن طريق تنزيل نسخة باستخدام http_archive
في Bazel، بل من خلال إرسال نسخة TSL الخاصة بـ Copybara إلى دليل third_party
لـ XLA.