איך נדחיתי פעמיים לפני שמיזגתי PR

ניסיתי לתרום ל-Awesome Second Brain. Awesome Second Brain הוא משאב קוד פתוח למערכות זיכרון וידע מבוססות AI. יש לו מעל 200 כוכבים וחוקים קפדניים מאוד. הגשתי stack מורכב: Hermes Agent, Obsidian, ו-Honcho.

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

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

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

2. היו לי מטא-נתונים לא מדויקים התבלבלתי בשמות של חברות. חשבתי ש-Plastic Labs יצרו את Obsidian. הם לא. טענתי שכל ה-stack הוא קוד פתוח. הוא לא. Obsidian ו-AgentMail הם קנייניים.

הלקח: ודאו כל פרט. בדקו את המנהל (maintainer), הרישיון וסטטוס ה-repo. אל תנחשו.

3. עשיתי טענות רחבות ללא הוכחות טענתי שה-stack הוא "כולו מקומי". זה היה שקרי מכיוון ש-AgentMail הוא שירות מאוחסן. טענתי שהוא "חינמי". זה היה שקרי מכיוון שלשירותים מאוחסנים יש עלויות.

הלקח: הגדירו את הטענות שלכם בצורה מדויקת. אם טענה אינה נכונה לגבי כל חלק ב-stack, ציינו זאת. השתמשו בביטויים כמו "משתנה לפי רכיב". כנות עדיפה על טענות כלליות מדי.

4. לא קראתי את ההנחיות תחילה קראתי את כללי התרומה רק אחרי הדחייה הראשונה שלי. הייתי צריך לקרוא אותם לפני שהתחלתי.

הלקח: קראו את הכללים פעמיים. הם קיימים כדי לחסוך לכם ולמנהל את הזמן.

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

Source: https://dev.to/saintchris_21/how-i-contributed-to-awesome-second-brain-and-what-i-learned-from-getting-rejected-32p4

Optional learning community: https://t.me/GyaanSetuAi