לחבר את GitHub ל-Notion

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

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

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

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

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

סנכרון זה אינו כולל בעיות (issues), תגובות, מוקצים או פרטי סקירה ב-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. יש לבחור את כל ההיסטוריה הזמינה או חלון היסטוריה.

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

Notion יוצרת GitHub Pull Requests בסעיף סרגל הצד 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, יש לפתוח את בקשת המשיכה באמצעות כתובת URL של GitHub ולבצע את השינוי ב-GitHub.

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

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

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

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

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

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

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