תובנות מהשקת קוד-פתוח

האתר של WaloViz , ה-GitHub Repo , דמו ב-Google Colab , דף הפרויקט בפורטפוליו

לפני שבועיים בדיוק השקתי את פרויקט הקוד הפתוח הראשון שלי, WaloViz.

וואו.

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

אבל זה המקום שבו אני נמצא עכשיו, היום, עדיף שאתחיל בהתחלה.

בפוסט הזה אשתף אתכם בתהליך שעברתי, אם אתם מתכננים להקים או להשיק פרויקט קוד-פתוח - זה הפוסט בשבילכם :)

אם אתם לא יודעים מה זה WaloViz, קראו את דף הפרויקט של WaloViz או את הבלוג פוסט של השקת WaloViz.

הכנות

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

ובכל זאת, עבדתי קשה על דברים אחרים וקריטיים יותר.
שלושה במיוחד:

“קוד-פתוח”יות

ניסיתי לעקוב אחרי עקרונות קוד-פתוח, קראו את opensource.guide, למדתי ממנו הרבה.
כמו כן, השקעתי זמן רב בשילוב כלי אוטומציה ופיתוח כדי להקל על ה-contributor המתחיל והמזדמן להצטרף:

1. Github Actions - פתרון CI\CD רב תכליתי עם קהילה ענקית, עבור תהליכי CI\CD אוטומטיים, WaloViz משתמשת בו כדי להפוך יצירת דוקומנטציה לאוטומטית, פרסום חבילות , בדיקות CI וכדו’.
2. VSCode Dev Containers - סביבת פיתוח מקומית מבוססת Docker, ל-On-Boarding קל ו-Setup לסביבת הפיתוח, אתה פשוט פותח את ה-repo וזה עושה זאת כל השאר בשבילך.
3. pre-commit - תשתית לניהול ה-pre-commit hooks, היא מריצה ולידציות ותיקונים של Pyright, Ruff, Prettier ועוד אוטומציות על כל הקוד בכל commit, כמו גם בכל push בעזרת Github Actions.
4. Pyright - עושה Static Typing ל-Python, זה חושף מלא באגים פוטנציאליים, שווה את המאמץ.
5. Ruff - עושה Python Formatting & Linting, זה מהיר ועצבני, הקוד שלכם ייראה וירגיש הרבה יותר טוב.
6. Prettier - עושהּ Formatting ל-Markdown, YAML ו-JSON, פשוט הופך דברים ליפים יותר :)

בקרוב אצור Github Template עבור חבילת קוד-פתוח מודרנית בפייתון עם כל אלה כלולים, אני אפרסם פוסט על זה אז הישארו מעודכנים!

דוקומנטציה טובה

ידעתי (וקיוויתי) שאנשים יקשרו את WaloViz ל-HoloViz ecosystem, אחד מסימני ההיכר של כל פרויקט HoloViz הוא תיעוד אינטראקטיבי מרשים ומושקע.
כדי ליצור את אותו המראה והתחושה הלכתי על שימוש ב-NBSite, שהיא תשתית הדוקומנטציה של HoloViz.

אני לא ממליץ להשתמש ב-NBSite.
NBSite מבוסס על Sphinx, ואם אתם לא מכוונים להיות שיבוט של פרויקט HoloViz, אתם יכולים פשוט להשתמש ב-Sphinx ישירות, זה אפילו יותר גמיש.

בכל אופן, NBSite אכן הגיעה עם extension-ים ופיטצ’רים שימושיים של Sphinx פשוט Out-of-the-Box, כמו הטמעה חלקה של output-ים של מחברות אינטראקטיביות בדוקומנטציה, כמו ממש בתחילת דף ה-Introduction של WaloViz.

כמו כן, השקעתי הרבה בתיעוד inline מקיף שהומר אוטומטית ל-API Reference Manual, זה טוב גם למשתמשים שצריכים לצלול פנימה, וגם ל-contributor-ים מתחילים שרק החלו לטבול את בהונותיהם.

הדוקומנטציה של WaloViz קיבלה משוב חיובי גורף, אבל אני מקדים את עצמי :)

מציאת קהילות יעד

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

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

אני ממליץ לבקש מהם לתמוך בפוסטים שלכם בקהילות המיינסטרים, אלו החשובות באמת.

קהילות מיינסטרים
ציוץ X, פוסט ב-LinkedIn, קבוצת פייסבוק ספציפית, אלה יתנו לכם חשיפה לקהל הרחב, לאנשים שאתם לא מכירים, למשתמשים האמיתיים הראשונים שלכם. הייתה לי רשימה של 3 קבוצות וואטסאפ מיינסטרים, 2 קבוצות בפייסבוק וערוץ דיסקורד אחד.

יש רק בעיה אחת, כדי לקבל תשומת לב כלשהי - צריך מסה קריטית של תשומת לב ראשונית.
תשומת לב היא כמו כסף, ברגע שיש לך קצת מהם - ניתן לייצר מהם עוד.
כדי להגיע למסה הקריטית של לייקים או מה שזה לא יהיה תרתמו את החברים והעמיתים לעזרתכם, זה עובד :)

במקרה שלי קהילת MDLI הייתה היעד המרכזי שלי, זו קהילת למידה עמוקה ישראלית, להצלחה שם הייתה משמעות רבה עבור WaloViz.
החברים שלי הביאו אותי ל-30 לייקים, בסופו של דבר בסך הכל קיבלתי 80 לייקים. מסה קריטית.

בדיעבד הייתי צריך להשקיע יותר בקהילות מיינסטרים בינלאומיות, ארחיב בהמשך.

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

קהילות מומחים אינן אלה עם מומחי דומיין - אלא אלה עם מומחי קוד-פתוח.

מצאו את אלה שיכולים להזדהות אתכם, אלה שיודעים מה זה להתחיל פרויקט קוד-פתוח כי הם היו שם.

הייתה לי בראש רק קהילת מומחים אחת, ערוץ הדיסקורד של Panel (חלק מה-HoloViz ecosystem).
אם הייתי יודע מה הולך לקרות - הייתי משקיע יותר בלמצוא קהילות מומחים נוספות.

התחלה חזקה

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

רצף האירועים הוביל לזינוק מדהים של עניין ב-1 באוגוסט, כפי שניתן לראות בניתוח המשתמשים הן עבור אתר הפורטפוליו הזה ממש והן עבור הדוקומנטציה של WaloViz:

ובתחילת הבלוג פוסט הזה ממש תוכלו לראות את העלייה המדהימה במספר הכוכבים ב-WaloViz Github Repo.

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

אבל זה למאוחר יותר, עכשיו בואו נעבור על כמה מהפוסטים והריפוסטים האהובים עלי שאפשרו ל-WaloViz להגיע ל-50 כוכבי Github.

MDLI

כפי שאמרתי, MDLI הייתה קהילת המיינסטרים שבראש סדר העדיפויות שלי, הנה הפוסט עצמו:

80 הלייקים ו-20 התגובות האלו היו ממש נחמדות ונתנו ל-WaloViz הרבה חשיפה, רבים שיבחו את איכות הדוקומנטציה, וכמו שאמרתי החברים והעמיתים תרמו את חלקם באופן מופלא, תודה חברים :)

ה-Discord של Panel

בכנות, לא ציפיתי להרבה מהקהילה הזו, זה ערוץ קטן מלא באנשים שמעולם לא פגשתי, אבל עמדתי להיות מאוד מופתע:

כמה ממנהיגי הקהילה שלהם התחילו לדבר איתי, חלק מהם פשוט התעניינו והתחילו לנבור בקוד שלי כדי להבין איך הוא עובד, חלק פתחו PR-ים כדי לשפר את WaloViz, וחלק… ובכן, חלק היו אדיבים מספיק כדי לעזור להפיץ את הבשורה :)

Panel - הפצת הבשורה

הדבר הראשון שקרה היה שהפוסט הראשון שלי ב-LinkedIn על WaloViz קיבל ריפוסט מ-Panel:

אז Panel פרסמו שני פוסטים שונים על WaloViz:

השבתי עם פוסט משלי ואני הצגתי את Panel הפעם:

כפי שאתם יכולים לראות אף אחד מהם לא קיבל הרבה לייקים, אז למה אני מתרגש מהם?

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

האינטראקציה הזו נתנה boost ל-WaloViz, גיוונה את הקהל שלי, התחילה שותפות וחיממה לי את הלב, תודה Panel!

הצד השטוח של המגלשה (לא עובד כמו באנגלית)

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

עכשיו, WaloViz לא גדלה בפופולריות, היא בסטטוס סטטי, עקומה שטוחה.
זוהי עקומה גרועה עבור פרויקט קוד-פתוח.

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

1. לעבוד על WaloViz - להתקדם ב-Roadmap של WaloViz, לתקן בעיות, לשפר את המהימנות, השימושיות והקריאות.
2. להמשיך להפיץ - להמשיך לפרסם עדכונים בבלוג הזה ובפלטפורמות אחרות, לפרסם פיטצ’ים והכרזות כמו גרסת הבטא.
3. ליצור משפכים - לשים את WaloViz בתוצאות החיפוש, בין אם ישירות כמו כתבת Medium, או בעקיפין כמו תשובה לשאלה רלבנטית ב-stackoverflow.
4. לחזק שותפויות - ליצור PR-ים לפרויקטים שכנים ולתקשר עם קהילות, כמו Panel או AudioSample החדשה והמרגשת (היא נראית מדהים, נסו אותה!)

אלו משימות לא קלות, הן דורשות זמן, סבלנות, נחישות ומשמעת.
לפחות עשיתי את הפוסט הזה, וזו הפצה נחמדה ;)

זהו לעת עתה, עוד בקרוב, הישארו מעודכנים