מפתחים חדשים
עמוד זה מסביר כיצד להתחיל כמפתח שרוצה לתרום לפרויקטים טכניים של ויקימדיה.
ברוכים הבאים!
הקהילה הטכנית של קרן ויקימדיה מקדמת בברכה תורמים חדשים!
הפכו לחלק מקהילה גלובלית, ועזרו להקל על הגישה לידע בחינם לכולם!
איך להתחיל לתרום
השלבים הבאים הם תיאור כללי של איך להתחיל לתרום:
- למד את היסודות של איך פרויקטים של תוכנה בקוד פתוח של ויקימדיה פועלים.
- קרא את הנחיות התקשורת.
- הגדר חשבונות: צור חשבון מפתח. בהתאם לסוג התרומה שברצונך לתרום, ייתכן שתצטרך גם להגדיר חשבונות בפבריקטור, ולהגדיר את Git ו־Gerrit.
- בחר פרויקט תוכנה
- בחר ופתור משימה (כתוב ובדוק את הקוד שלך)
- הגש את שינויי הקוד שלך עקוב אחר המדריך לסקירת הקוד שלכם והגשת תיקון.
שאר המדריך מספק פרטים נוספים על התהליך.
יסודות אופן פעולתם של פרויקטים בתוכנת ויקימדיה
לויקימדיה יש פרויקטים של תוכנה בתחומים רבים ושונים.
מתחזקי כל פרויקט תוכנה בוחרים את התשתית שהם מעדיפים. באופן כללי, לרוב מיזמי התוכנה יש:
- כלי מעקב משימות שבו מדווחים, מנוהלים ונדונים באגים בתוכנה ובקשות לשיפור. דוגמאות לכך הן Wikimedia Phabricator, GitHub, או Wikimedia GitLab.
- אתר למאגר קוד שבו ניתן 'לבדוק' את קוד המקור של כולם. דוגמאות לכך הן Wikimedia Gerrit, GitHub, או Wikimedia GitLab.
- כלי לסקירת קוד שבו שינויי קוד מוצעים ('תיקונים') נידונים ומשתפרים. דוגמאות לכך הן Wikimedia Git/Gerrit, GitHub או GitLab. לאחר שהתיקון המוצע שלך מאושר וממוזג במאגר הקוד, שינויי הקוד שלך הופכים לזמינים לכולם.
- ייעודי מקומות דיון כלליים על פרויקט התוכנה ולעזרה ותמיכה. מקומות אלה יכולים להיות רשימות תפוצה, ערוצי צ'אט של IRC, דפי ויקי או מקומות אחרים. המקומות המדויקים תלויים בכל פרויקט.
בכל שלב, אם אתם נתקלים בבעיות או זקוקים לעזרה, אנא שאלו. כדי לשאול שאלות טובות במקומות הנכונים, עקבו אחר 'עצות לתקשורת'.
סקירה כללית של תחומים טכניים
לסקירה כללית של טכנולוגיית ויקימדיה ודוגמאות לתחומים העיקריים שבהם מפתחים יכולים לתרום, בקרו באתר מבוא למערכת הטכנית של ויקימדיה.
תרומה לתוכנה במדיה־ויקי
האם אתה משתמש באתר הויקי של מדיה-ויקי ומחפש להוסיף תכונה או לתקן באג בויקי? אנא עיין בכיצד להפוך למתכנת מדיה־ויקי כדי ללמוד כיצד למצוא ולתרום לחלק של פרויקט התוכנה במדיה-ויקי שאתה מחפש.
בחר פרויקט תוכנה
הפרויקטים הבאים מציעים משאבים, חונכות, ואנחנו מחפשים מפתחים חדשים שיתרמו להם. בחר אחד מהפרויקטים הבאים ופעל לפי תיעוד הפרויקט להגדרת סביבת הפיתוח שלך, בחר משימה לעבוד עליה, פתור את המשימה והגש את שינויי הקוד שלך לבדיקה. אתם חופשיים לתרום לפרויקטים אלה או לכל פרויקט אחר שמעניין אתכם הקשור לויקימדיה. את רובם ניתן למצוא על ידי חיפוש ב־Phabricator או באינטרנט.
קורא במצב לא מקוון בשביל אנשים שאין להם גישה לאינטרנט
- מיומנויות נדרשות: Java/Kotlin (Android), Swift (iOS), Qt (desktop), NodeJS (mediawiki offliner), C++, Python (WP1)
- נהיה בקשר: רשימת תפוצה / סלאק
- קבל את קוד המקור: GitHub
- קרא את התיעוד הכללי ואת הקובץ README.md של הפרויקט המתאים
- בדוק את המשימות המומלצות לעבודה: אנדרואיד, iOS, JS, mwoffliner ב־GitHub
- מנטור (ים): Matthieu Gauthier, Emmanuel Engelhart, Stephane Coillet-Matillon
יישום ויקישיתוף לאנדרואיד
יישום למכשירי אנדרואיד להעלאת תמונות לויקישיתוף
- מיומנויות נדרשות: Java
- נהיה בקשר: Google Groups
- קבל את קוד המקור: GitHub
- קרא את התיעוד
- בדוק את המשימות המומלצות לעבודה: GitHub
- מנטור (ים): Josephine Lim
Pywikibot
ספריית פייתון ואוסף של סקריפטים שהופכים עבודה לאוטומטית באתרי מדיה־ויקי.
- מיומנויות נדרשות: Python
- נהיה בקשר: #pywikibot connect on irc.libera.chat / Mailing list
- קבל את קוד המקור: השתמש ב־git כדי לקבל את קוד המקור של [1]
- קרא את התיעוד ואת ההפניה ל־API
- בדוק את המשימות המומלצות לעבודה: Phabricator
- מנטור (ים): xqt
Scribe
Scribe מספק מקלדות מבוססות ויקינתונים ללומדי שפה שנייה. התכונות כוללות תרגום, צימוד פעלים וביאור שם עצם־מין. פרויקט זה פתוח מאוד למי שרוצה ללמוד את השפות הנדרשות וכיצד לעבוד עם ויקינתונים!
- כישורים נדרשים: Swift עבור Scribe-iOS; Kotlin עבור Scribe-Android; Python ו/או Wikidata Query Service עבור Scribe-Data חילוץ נתונים בשפה שלנו - ממשק שורת פקודה (CLI)
- נהיה בקשר: GitHub או דוא"ל
- קבל את קוד המקור: GitHub
- קרא את הנחיות התרומה: Scribe-iOS, Scribe-Android או Scribe-Data
- בדוק את המשימות המומלצות: Scribe-iOS, Scribe-Android או Scribe-Data
- מנטור (ים): Andrew McAllister
VideoCutTool
כלי לעריכת סרטונים בויקישיתוף.
- מיומנויות נדרשות: React JS, Node JS.
- נהיה בקשר: #VideoCutTool ב־Zulip
- קבל את קוד המקור: ראה קישור בתיאור בפבריקטור
- קרא את התיעוד
- בדוק את המשימות המומלצות לעבודה: Phabricator
- מנטור (ים): Gopa Vasanth, Varun Shrivastava, Punith B Nayak
האם אתה מתחזק ורוצה שהפרויקט שלך ייכלל ברשימת מיזמי התוכנה למעלה? למידע נוסף והצטרף!
תוכניות הסברה ומשימות בודדות
בנוסף למיזמי התוכנה המומלצים לעיל, ישנן דרכים נוספות לבחור פרויקט או משימה לעבוד עליהם:
תוכניות הסברה
משימות התחלתיות מתאימות
עם זאת, ייתכן שלא יהיו מנטורים זמינים עבור משימות אלו, וייתכן שהתיקונים המוצעים שלך לא יקבלו ביקורות מהירות.
עצות לתקשורת
בצעו את העצות הבאות כדי לתקשר ביעילות ולקבל עזרה מחברי הקהילה.
השתמשו במשימות הפבריקטור ביעילות
כאשר אתם מתכננים לעבוד על משימת Phabricator:
- אין צורך לבקש רשות: תוכלו לעבוד על משימות שלא הוקצו מבלי לבקש מאף אחד להקצות לך אותן. אין סמכות שמקצה משימות או את מי צריך לשאול קודם.
- אם למשימה כבר יש תיקון עדכני ב־Gerrit, בחר משימה אחרת לעבוד עליה במקום זאת.
- אם תיקון קיים ב־Gerrit שלא מוזג ושלא ראה שינויים במשך זמן רב, ניתן לשפר את התיקון הקיים, בהתבסס על המשוב ב־Gerrit ובמשימה.
- בדקו את הנושא בעצמכם: כשאתם שוקלים לעבוד על משימה, בצעו מחקר לפני שאתם מתחילים לכתוב קוד. התבוננו בקוד, נסו להבין מה הוא אמור לעשות, קראו תיעוד רלוונטי ונסו למצוא את המקומות שבהם אתם צריכים לבצע שינויים בקוד.
- במשימת Phabricator, השתמש בתגיות הפרויקט בסרגל הצד כדי למצוא את מאגר הקוד עבור המשימה.
- אם אין לכם מושג איך לתקן את הבאג, שקלו למצוא תחילה דרך קלה יותר.
- אינכם צריכים להכריז על התוכניות שלכם לפני שאתם מתחילים לעבוד על משימה, אך עליכם להודיע שאתם עובדים עליה.
- כשאתם מתחילים לעבוד, הגדירו את עצמכם כמקבלי המשימה על ידי לחיצה על עריכת משימה… ב־Phabricator, והגדירו את שם המשתמש שלכם ב־Phabricator בשדה הוקצה ל־. זה מעביר לאחרים את המסר שאתם עובדים עליה, כדי שלא יעשו עבודה כפולה.
- כאשר התוכניות או תחומי העניין שלכם משתנים: אם אינכם עובדים עוד על משימה, הסירו את עצמכם כמקבלי המשימה. זה אומר לאחרים שהם יכולים לעבוד על המשימה, והם לא יצפו ממכם להמשיך לעבוד עליה.
- יש להקפיד על כללי הנימוס של הפבריקטור.
- במשימות פבריקטור, יש לדון רק בשאלות ספציפיות בנוגע לנושא המשימה. אל תשתמשו בפבריקטור כדי לשאול שאלות כלליות, כמו כיצד להגדיר סביבת פיתוח או כיצד לתקן בעיות עם Gerrit.
חברו שאלות טובות
- אל תבקשו לשאול... פשוט תשאלו!.
- היו ספציפיים וספקו הקשר: במקום פשוט לשאול "האם תוכל לתת לי מידע נוסף?", "אנא תן לי הדרכה" או "אנא ספר לי איך להתחיל", כללו את המידע הבא בשאלתכם:
- מה אתם מנסים להשיג?
- מה כבר ניסיתם? העתיקו והדביקו את הפקודות שלכם ואת הפלט שלהן (אם הן לא ארוכות מדי) במקום לנסח אותן מחדש במילים שלכם.
- מה כבר גיליתם במהלך המחקר שלכם? כללו קישורים לקוד, תיעוד או משאבים אחרים שכבר עיינתם בהם.
- השתמשו בכותרות ובשורות נושא ספציפיות בתקשורת שלכם. "טיוטת הצעה" או "זקוק לעזרה" אינם ספציפיים.
- שמרו על שיחות קריאות: כשאתם משיבים ב־Zulip, במשימות של Phabricator, או ברשימות תפוצה, צטטו רק קטעים מתגובות קודמות הרלוונטיים לתגובתכם. אם אתם מצטטים תגובה קודמת שלמה, זה מקשה על קריאת השרשורים.
יש לפעול לפי מדיניות התקשורת ושיטות העבודה המומלצות
לפני שאתם שולחים או מפרסמים את שאלתכם:
- קראו ופעלו לפי קוד ההתנהגות למרחבים הטכניים של ויקימדיה.
- השתמשו בinclusive language: במקום להשתמש במונחים המניחים זהות מגדרית (כמו "חברה", "גברתי" או "אדוני") השתמשו בשם האדם במקום זאת.
שאלו במקום הנכון
- שאלו בפומבי: אל תשלחו הודעות פרטיות אם נושא השיחה אינו סודי. הודעות פרטיות לא עוזרות לאחרים.
- שאלו ודונו במקום הטוב ביותר:
- במשימות פבריקטור, יש לדון רק בשאלות ספציפיות בנוגע לנושא המשימה.
- שאלו שאלות טכניות כלליות, כמו כיצד להגדיר סביבת פיתוח או כיצד לתקן בעיות עם Gerrit, במקומות המפורטים בדרכי תקשורת.
- אם אתם משתתפים בתוכנית הסברה, אז Zulip מיועד לדיון בשאלות בנוגע לתוכניות ההסברה עצמן.
היו סבלניים
לאחר פרסום שאלתכם:
- אל תבקשו מאנשים סקירת קוד בהודעה נפרדת. אנשים מקבלים התראות מ־Gerrit וה־Phabricator ויגיבו כשהם יכולים.
- כשאתם מבקשים משוב והערות, במיוחד בסופי שבוע ובחגים, ייתכן שתצטרכו להמתין עד לחידוש שעות הפעילות. בערוצי צ'אט כמו IRC: אם אף אחד לא עונה, נסו שוב בזמן אחר; אל תוותרו!
- אם לא קיבלתם תשובה גם לאחר המתנה וסבלנות, שקלו אם ערוצי תקשורת אחרים עשויים להיות מקום טוב יותר לשאול את שאלתכם.
משאבים נוספים
- מבוא למערכת האקולוגית הטכנית של ויקימדיה מספק סקירה כללית של טכנולוגיית ויקימדיה, תוך התמקדות בתחומים העיקריים שבהם מפתחים יכולים לתרום.
- כיצד לתרום מפרט דרכים רבות נוספות לתרום, כולל תחומים כמו תיעוד, בדיקות ועוד.
- כיצד להפוך למתכנת מדיה־ויקי: למפתחים שרוצים לעבוד על ליבת מדיה-ויקי או על הרחבות מדיה-ויקי.
- מרכז המפתחים: משאבים נוספים למפתחי ויקימדיה ותיקים.
- כדי לשאול שאלות ולהצטרף לדיונים כלליים, בדקו את המקומות המפורטים בתקשורת.
- מדריכי ויקימדיה: אינדקס של מדריכים הכוללים שפות, ממשקי API ומסגרות שונות במערכת הטכנולוגיה של ויקימדיה.
- תמיכה במשתתפים חדשים בהאקתונים
- תמיכה למתחילים בהאקתונים ומדריך המנטורים הנלווה אליו
- מדור חדשים במדריך ההאקתונים, כמו גם דף טיפים לחונכות
- דף הדרכה למתחילים בהאקתון ויקימדיה 2022