Dai il tuo contributo

Il repository principale Blockly contiene il codice necessario per eseguire qualsiasi applicazione basata su Blockly.

Cose da sapere

Ecco una breve panoramica dei fatti principali che devi conoscere per creare un PR.

  • Il ramo di lavoro è in fase di sviluppo e tutte le PR devono essere rivolte allo sviluppo.
  • Devi compilare il modello di richiesta di pull con le informazioni richieste.
  • Il codice deve essere conforme alla Guida di stile TypeScript di Google.
  • Utilizza i commissioni convenzionali nei messaggi di commit e i titoli delle richieste di pull.
  • Le stringhe visibili agli utenti devono essere nel file /msg/messages.js per poter essere tradotte. Meno del 6% delle persone nel mondo parla inglese in modo nativo.
  • Il testo sui blocchi deve generalmente essere tutto minuscolo (come le parole chiave nella maggior parte dei linguaggi di programmazione).
  • Garantire la compatibilità con le versioni precedenti. Esistono molte app Blockly e che non fanno danni a tutti gli altri.

  • Ogni nuovo file di codice deve essere preceduto da Apache License v2.0:

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

Apporta e verifica una modifica

  1. Esegui npm install per installare le dipendenze.
  2. Esegui npm run start per avviare un server che gestisce il parco giochi. Puoi usare questa pagina per testare il comportamento esistente. Per ulteriori informazioni, consulta la pagina playground.
  3. Apporta le modifiche necessarie al codice.
  4. Se hai lasciato il server in esecuzione, aggiorna per visualizzare le modifiche. In caso contrario, riavvia il server e verifica che il codice funzioni come previsto e che non siano presenti errori o avvisi nella console.
  5. Esegui npm run build e assicurati che non ci siano errori di build.
  6. Scrivere test automatici. In genere si tratta di test mocha nella directory tests/mocha, ma potremmo chiederti di eseguire altri tipi di test.
  7. Esegui npm run format per formattare il codice e risolvere automaticamente alcuni problemi di lint.
  8. Esegui npm test per eseguire i test automatici. Viene eseguita anche l'operazione eslint.
  9. Se si verificano errori di lint, esegui npm run lint:fix per risolvere i problemi risolvibili automaticamente. Risolvi eventuali avvisi o errori lint rimanenti.
  10. Se tutti i test hanno esito positivo, puoi aprire un PR contro lo sviluppo delle tue modifiche.