איך מתחילים לתרום ל-Blockly

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

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

איזה מאגר?

מאגר מכיל את כל הקבצים של פרויקט יחיד. ל-Blockly יש שני מאגרי מידע: blockly core ו-blockly-samples.

‫Blockly core הוא המאגר של ספריית Blockly. אפשר להשתמש במאגר הזה אם רוצים לשנות את התנהגות הליבה של Blockly באופן שיחול על כל המשתמשים בספרייה.

Blockly samples הוא המאגר של דוגמאות, פלאגינים וסדנאות קוד. אפשר להשתמש במאגר הזה אם רוצים ליצור או לשנות פלאגין, לכתוב Codelab או ליצור או לשנות דוגמה.

הדרכה מפורטת

אלה השלבים הכלליים שצריך לבצע בכל פעם שרוצים לערוך את ההגדרות.

1. מתקינים את Git ואת Node באמצעות הקישורים שבקטע כלים.
2. מבצעים Fork ושכפול של המאגר. ב-GitHub יש מדריך מצוין בנושא יצירת עותק של מאגר. כדי להחיל את השינוי על Blockly, פשוט מחליפים כל מופע של octocat/Spoon-Knife ב-RaspberryPiFoundation/blockly או ב-RaspberryPiFoundation/blockly-samples, בהתאם למאגר שבו רוצים לעבוד.
3. סנכרון של העותק המפוצל. ב-GitHub יש גם הדרכה בנושא סנכרון של עותק.
4. מעיינים בענף הראשי. ב-Blockly Core, זהו הענף develop. ב-blockly-samples זה הענף master.
5. מתקינים יחסי תלות וכלי בנייה על ידי הפעלת npm install בספריית הבסיס.
6. יוצרים ענף חדש על ידי הפעלת הפקודה git checkout -b myBranchName במסוף. השם צריך לעזור לכם לזכור על מה אתם עובדים.
7. מבצעים את השינויים הרצויים.
8. מאמתים את השינויים לפי המדריך לליבה או לדוגמאות.
9. שומרים את השינויים באמצעות git commit -am "fix: My commit message". מידע נוסף על הודעות של ביצוע פעולות
10. מעלים את השינויים ל-GitHub באמצעות git push origin myBranchName.
11. פותחים בקשת מיזוג כשהקוד מוכן. חבר בצוות Blockly יבדוק את השינויים וימזג אותם עם Blockly אם הם יאושרו. מידע נוסף זמין במאמר תהליך בדיקת בקשות למשיכת שינויים.