מיוחדים (quirks)

מטרת המסמך הזה היא לתאר את הבעיות שעשויות לצוץ במהלך הוספת התוכן, בגלל הכלי שמנהל את ההעתקה של המקור הלוך ושוב מהמאגר הפנימי של Google. הכלי הזה נקרא Copybara.

מקור מידע פנימי

מכיוון שמקור האמת של הקוד במאגר הזה הוא המאגר הפנימי של Google, חברת Copybara מבצעת טרנספורמציות בקוד בכל פעם שמיובאים ומיוצאים הקוד. זה אומר שלפעמים שינויים שנראים נורמליים עלולים לגרום לשיבושים פנימיים באופן מפתיע.

סטטוס מיזוג של PR וחוסר עקביות בהבדלים

מאחר שמקור האמת הוא פנימי, יחסי ה-PR לא ממוזגים ישירות, הם מיובאים למאגר הפנימי של Google שם הם עוברים בדיקה נוספת, ולאחר מכן השינוי הפנימי נשלח ומיוחס למחבר ה-PR. בגלל הטרנספורמציות ש-Copybara מחילה, לא מובטח שההפרש יהיה זהה (לדוגמה, Copybara מיישמת עיצוב בייבוא).

לכן, Copybara לא תסמן את ה-PR כמוזג, היא תסגור את ה-PR, ובנפרד תחיל התחייבות שאמורה להיות קרובה מאוד ל-PR.

תלות ב-TSL בעותק

כפי שמיושם בשלב זה, כדי למנוע התחייבויות לא תקינות באופן זמני, האפשרות XLA תלויה ב-TSL לא בהורדת עותק באמצעות http_archive של Bazel, אלא בהעתקת TSL של Copybara למאגר ה-third_party של XLA.