מפתחים חדשים/עצות לתקשורת

בצעו את העצות הבאות כדי לתקשר ביעילות ולקבל עזרה מחברי הקהילה.

השתמשו במשימות הפבריקטור ביעילות

כאשר אתם מתכננים לעבוד על משימת Phabricator :

• אין צורך לבקש רשות: תוכלו לעבוד על משימות שלא הוקצו מבלי לבקש מאף אחד להקצות לך אותן. אין סמכות שמקצה משימות או את מי צריך לשאול קודם.
  • אם למשימה כבר יש תיקון עדכני ב־Gerrit, בחר משימה אחרת לעבוד עליה במקום זאת.
  • אם תיקון קיים ב־Gerrit שלא מוזג ושלא ראה שינויים במשך זמן רב, ניתן לשפר את התיקון הקיים, בהתבסס על המשוב ב־Gerrit ובמשימה.
• בדקו את הנושא בעצמכם: כשאתם שוקלים לעבוד על משימה, בצעו מחקר לפני שאתם מתחילים לכתוב קוד. התבוננו בקוד, נסו להבין מה הוא אמור לעשות, קראו תיעוד רלוונטי ונסו למצוא את המקומות שבהם אתם צריכים לבצע שינויים בקוד.
  • במשימת Phabricator , השתמש בתגיות הפרויקט בסרגל הצד כדי למצוא את מאגר הקוד עבור המשימה.
  • אם אין לכם מושג איך לתקן את הבאג, שקלו למצוא תחילה דרך קלה יותר.
• אינכם צריכים להכריז על התוכניות שלכם לפני שאתם מתחילים לעבוד על משימה, אך עליכם להודיע שאתם עובדים עליה.
  • כשאתם מתחילים לעבוד, הגדירו את עצמכם כמקבלי המשימה על ידי לחיצה על עריכת משימה… ב־Phabricator, והגדירו את שם המשתמש שלכם ב־Phabricator בשדה הוקצה ל־. זה מעביר לאחרים את המסר שאתם עובדים עליה, כדי שלא יעשו עבודה כפולה.
  • כאשר התוכניות או תחומי העניין שלכם משתנים: אם אינכם עובדים עוד על משימה, הסירו את עצמכם כמקבלי המשימה. זה אומר לאחרים שהם יכולים לעבוד על המשימה, והם לא יצפו ממכם להמשיך לעבוד עליה.
• יש להקפיד על כללי הנימוס של הפבריקטור.
  • במשימות פבריקטור, יש לדון רק בשאלות ספציפיות בנוגע לנושא המשימה. אל תשתמשו בפבריקטור כדי לשאול שאלות כלליות, כמו כיצד להגדיר סביבת פיתוח או כיצד לתקן בעיות עם Gerrit.
  • Don't post comments that amount to "Please review my patch" or "I submitted a patch at this link". If you format your commit message correctly , then the patch will be automatically linked to the task, and posting a patch is already an implied request to review it, so stating that explicitly adds nothing.

חברו שאלות טובות

• אל תבקשו לשאול... פשוט תשאלו!.
• היו ספציפיים וספקו הקשר: במקום פשוט לשאול "האם תוכל לתת לי מידע נוסף?", "אנא תן לי הדרכה" או "אנא ספר לי איך להתחיל", כללו את המידע הבא בשאלתכם:
  • מה אתם מנסים להשיג?
  • מה כבר ניסיתם? העתיקו והדביקו את הפקודות שלכם ואת הפלט שלהן (אם הן לא ארוכות מדי) במקום לנסח אותן מחדש במילים שלכם.
  • מה כבר גיליתם במהלך המחקר שלכם? כללו קישורים לקוד, תיעוד או משאבים אחרים שכבר עיינתם בהם.
• השתמשו בכותרות ובשורות נושא ספציפיות בתקשורת שלכם. "טיוטת הצעה" או "זקוק לעזרה" אינם ספציפיים.
• שמרו על שיחות קריאות: כשאתם משיבים ב־Zulip, במשימות של Phabricator, או ברשימות תפוצה, צטטו רק קטעים מתגובות קודמות הרלוונטיים לתגובתכם. אם אתם מצטטים תגובה קודמת שלמה, זה מקשה על קריאת השרשורים.

יש לפעול לפי מדיניות התקשורת ושיטות העבודה המומלצות

לפני שאתם שולחים או מפרסמים את שאלתכם:

• קראו ופעלו לפי קוד ההתנהגות למרחבים הטכניים של ויקימדיה.
• השתמשו בinclusive language : במקום להשתמש במונחים המניחים זהות מגדרית (כמו "חברה", "גברתי" או "אדוני") השתמשו בשם האדם במקום זאת.

שאלו במקום הנכון

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

היו סבלניים

לאחר פרסום שאלתכם:

• אל תבקשו מאנשים סקירת קוד בהודעה נפרדת. אנשים מקבלים התראות מ־Gerrit וה־Phabricator ויגיבו כשהם יכולים.
• כשאתם מבקשים משוב והערות, במיוחד בסופי שבוע ובחגים, ייתכן שתצטרכו להמתין עד לחידוש שעות הפעילות. בערוצי צ'אט כמו IRC: אם אף אחד לא עונה, נסו שוב בזמן אחר; אל תוותרו!
• אם לא קיבלתם תשובה גם לאחר המתנה וסבלנות, שקלו אם ערוצי תקשורת אחרים עשויים להיות מקום טוב יותר לשאול את שאלתכם.