תרומה ל-Core

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

חשוב לדעת

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

• ההסתעפות הפעילה היא פיתוח ואת כל פרסומי ה-PR צריך להפנות לפיתוח.
• צריך למלא את המידע המבוקש בתבנית של בקשת המשיכה.
• הקוד חייב להתאים למדריך הסגנון של TypeScript של Google.
• להשתמש בהתחייבויות קונבנציונליות בהודעות השמירה ולמשוך כותרות של בקשות.
• מחרוזות גלויות למשתמש חייבות להיות בקובץ /msg/messages.js כדי שאפשר יהיה לתרגם אותן. פחות מ-6% מהאנשים בעולם דוברים אנגלית.
• הטקסט בבלוקים צריך בדרך כלל להיות באותיות קטנות (בדיוק כמו מילות המפתח ברוב שפות התכנות).
• שמירה על תאימות לאחור. יש שם המון אפליקציות של Blockly, לא כדאי לגרום נזק לכולם.

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

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

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

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