לחבר את GitHub ל-Notion

סנכרון מנוהל עם GitHub מביא ל-Notion את העבודה שתבחרו מ-GitHub: בקשות משיכה (pull requests), בעיות (issues) או את שתיהן. Notion מייבאת את הרשומות הקיימות שלכם ובודקת ברקע אם יש עדכונים ב-GitHub.

המדריך הזה עוסק ב-סנכרון מאגר ידע בהגדרות החיבור שלכם ל-GitHub. מאפיינים מסונכרנים הם לקריאה בלבד. שינויים בבקשות משיכה ובבעיות מבצעים ב-GitHub.

בוחרים מה להביא ל-Notion מהמאגרים הזמינים דרך התקנה של GitHub App: בקשות משיכה, בעיות או את שתיהן. המאגרים שתבחרו יסונכרנו עם Notion.

המאפיין מחבר (GitHub) מכיל את שם המשתמש ב-GitHub. מחבר הוא מאפיין אדם ב-Notion כאשר האימייל הציבורי הזמין של המחבר תואם לחבר בסביבת העבודה.

המאפיין תיאור מסנכרן את תיאור בקשת ה-Pull כטקסט פשוט, שמועתק בדיוק כפי שנכתב ב-GitHub. הוא אינו מוצג כ-Markdown.

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

תצטרכו:

• חברות בסביבת העבודה של Notion.

• חשבון GitHub עם גישה למאגרים שברצונך לסנכרן.

• התקנת אפליקציית GitHub עם גישה למאגרים אלו.

• תוכנית Business (גם Mobile Business מתאימה). סנכרון GitHub אינו זמין בתוכניות אחרות.

גם חשבון ה-GitHub שלך וגם התקנת האפליקציה זקוקים לגישה. ייתכן שארגון ה-GitHub שלך ידרוש מבעלים לאשר או להתקין את האפליקציה.

1. ב-Notion, עבור אל Settings → Connections → GitHub.

2. יש לפתוח את Database sync ולחבר את חשבון ה-GitHub שלך אם עדיין לא נעשה זאת.

3. יש להשלים את שלבי האישור וההתקנה של GitHub.

4. יש לבחור את הארגון או החשבון שמאגריו ברצונך לסנכרן. במקרה שיש צורך בהוספת התקנה נוספת, יש להשתמש ב-Add organization….

5. יש לבחור את מאגרי הידע שייכללו.

6. נותנים לסנכרון שם ובוחרים מה להביא ל-Notion: בקשות משיכה, בעיות או את שתיהן.

7. יש לבחור את כל ההיסטוריה הזמינה או חלון היסטוריה.

8. בחרו ב-יצירת סנכרון.

Notion יוצרת את מאגר הידע המסונכרן במקטע 'Private' בסרגל הצד שלכם ומתחילה לייבא רשומות תואמות.

בייבוא הראשון, Notion קוראת את בקשות המשיכה והבעיות שבחרתם מכל מאגר שבחרתם, החל מהרשומות שעודכנו לאחרונה ועד לרשומות הישנות יותר בטווח ההיסטוריה שנבחר.

לאחר הייבוא, Notion בודקת בקביעות אם יש רשומות חדשות או מעודכנות בכל מאגר. שינויים כמו תווית חדשה, בקשת משיכה שנסגרה או בעיה שנפתחה מחדש יעדכנו את המאפיינים המתאימים ב-Notion.

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

יש לבחור All history, Last 30 days, Last 90 days או Last 365 days. כאשר מוצע סנכרון כל ההיסטוריה כרשימה נפתחת, יש להשאיר את Sync all available history מופעל כדי לכלול את כל בקשות המשיכה הזמינות.

החלון משתמש בזמן Updated At של בקשת המשיכה. הוא לא תלוי מתי בקשת המשיכה נוצרה או אם היא פתוחה, סגורה או ממוזגת.

לדוגמה, בקשת משיכה או בעיה פתוחה שלא השתנתה במשך יותר מ-90 יום עשויה להימצא מחוץ לטווח של 90 יום.

יש לפתוח את הסנכרון ב-Settings → Connections → GitHub → Database sync.

• הוספה או הסרה של בעיות או בקשות משיכה: משנים את סוג הרשומות שהסנכרון מביא ובוחרים ב'שמירת שינויים'. הוספת סוג מייבאת את הרשומות המתאימות לו. הסרת סוג מסירה את הדפים האלה. הרשומות שכבר ייבאתם מהסוגים שבחרתם להשאיר נשארות במקומן.

• Add repositories: יש לערוך את הבחירה ולבחור ב-Save changes. Notion מייבאת בקשות משיכה תואמות ממאגרי הידע שנוספו.

• Remove repositories: יש לבטל את בחירתם ולשמור. דפי בקשות המשיכה המסונכרנים שלהם יוסרו מ-Notion.

• היסטוריית שינויים: חלון ארוך יותר מייבא רשומות נוספות. חלון קצר יותר מסיר רשומות מחוץ לחלון החדש.

• Pause updates: יש לבחור ב-השהיה סנכרון. הנתונים וההגדרות הקיימים נשארים.

• Resume updates: יש לבחור ב-חדש סנכרון כדי להמשיך בסנכרון.

לפני הסרת מאגרים או קיצור היסטוריה, יש לשמור כל מידע שקיים ב-Notion בלבד שאתה צריך מהדפים המושפעים.

יוצרים תצוגות לפי מאגר, מצב, יוצר או תווית. מוסיפים מאפיינים משלכם כדי לעקוב אחר המוכנות להפצה או לקשר בקשות משיכה ובעיות לתהליך התכנון של הצוות שלכם. הערכים במאפיינים שהוספתם נשארים ב-Notion.

כדי לשנות מאפיין מ-GitHub, פותחים את הרשומה באמצעות GitHub URL ומבצעים את השינוי ב-GitHub.

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

יש לבדוק שהחשבון של GitHub והתקנת האפליקציה הנכונים נבחרו. יש לוודא שלחשבון שלך וגם לאפליקציה יש גישה למאגר. אם ארגון מגביל התקנות אפליקציות, יש לבקש מבעלים לאשר גישה.

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

לשם משתמש ב-GitHub לא תמיד יש אימייל ציבורי זמין שתואם לחבר בסביבת העבודה ב-Notion. יש להשתמש ב-מחבר (GitHub) כדי לזהות את המחבר כאשר מאפיין האדם ריק. שינויים באימייל של המחבר או בחברות בסביבת העבודה עשויים שלא לרענן אוטומטית בקשות משיכה מסונכרנות ישנות.

מוודאים שסוג הרשומה כלול בסנכרון, שהמאגר שלה נבחר, שהעדכון האחרון שלה נמצא בטווח ההיסטוריה ושאין בתצוגה שלכם ב-Notion מסנן שמסתיר אותה. ייתכן שהייבוא הראשון עדיין מתבצע.

יש לפתוח את פרטי הסטטוס של הסנכרון. יש לחבר מחדש את חשבון ה-GitHub שלך או לשחזר את הגישה למאגר אם תתבקש. מגבלות בקשות של GitHub והפסקות זמניות עלולות לעכב עדכונים בזמן ש-Notion מנסה שוב.

להשוואה עם Workers והנחיות לפתרון בעיות משותפות, יש לראות את סנכרון נתונים מכלי עבודה אחרים ל-Notion →.