משפרים ומשפיעים על 'טעימות'

הקטע Blockly Samples כולל תוכן נוסף שקשור ל-blockly שלא נכלל במאגר הליבה, כולל יישומי פלאגין, Codelabs וקוד לדוגמה. אפשר לקרוא פרטים נוספים על כל אחד מהמאגרים האלה בדף Repository.

חשוב לדעת

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

• ההסתעפות הפעילה היא מאסטר וכל יחסי הציבור צריכים להתבצע מול מאסטר.
• מריצים את npm install ברמה הבסיסית (root) של דוגמאות בלוקים, ולא ברמת הפלאגין הספציפי. blockly-samples הוא מונורפו. כלומר, הוא מכיל מספר חבילות באותו מאגר, והתקנה ברמה הבסיסית (root) היא חלק מתהליך ניהול המונורפו עם Lrna.
• הקוד חייב להתאים למדריך הסגנון של JavaScript של Google או למדריך הסגנון של TypeScript, בהתאם לשפה שבה משתמשים.
• להשתמש בהתחייבויות קונבנציונליות בהודעות השמירה ולמשוך כותרות של בקשות.

• לקובצי קוד חדשים חייבת להיות קידומת לרישיון Apache גרסה 2.0:

  /**
   *   @license
   *   Copyright <Current YYYY> Google LLC
   *   SPDX-License-Identifier: Apache-2.0
   */
  

ביצוע ואימות של שינוי

1. מריצים את הפקודה npm install ברמה הבסיסית (root) של דוגמאות בלוקים כדי להתקין יחסי תלות.
2. מריצים את npm run start בספרייה של פלאגין כדי ליצור ולהפעיל שרת שמפעיל את דף הבדיקה של הפלאגין. ניתן להשתמש בדף הזה כדי לראות את ההתנהגות הקיימת של פלאגין. אם מוסיפים פלאגין חדש, צריך להפוך אותו לדף בדיקה שימושי כדי שאנשים אחרים יוכלו לראות מה הפלאגין עושה. למידע נוסף, ראו playground.
3. בצע את השינויים הנדרשים בקוד של הפלאגין.
4. אם השארתם את השרת פועל, השינויים שלכם ייטענו באופן אוטומטי. אחרת, הפעילו מחדש את השרת וודאו שהפלאגין פועל כצפוי ושאין שגיאות או אזהרות במסוף.
5. מריצים את הפקודה npm run build ומוודאים שאין שגיאות build.
6. כתיבת בדיקות מוקה אוטומטיות בספרייה test/.
7. מריצים את הפקודה npm run test כדי להריץ את הבדיקות האוטומטיות.
8. מריצים את הפקודה npm run lint:fix כדי לתקן שגיאות איתור שגיאות בקוד. טפלו בכל האזהרות או השגיאות שנותרו.
9. מריצים את הפקודה npm run format כדי להפעיל את העיצוב האוטומטי.
10. אם כל הבדיקות עברו בהצלחה, אתם מוכנים לפתוח יחסי ציבור (PR) נגד מאסטר עם השינויים.