Cómo contribuir al núcleo

El repositorio principal de Blockly contiene el código necesario para ejecutar cualquier aplicación basada en Blockly.

Información importante

A continuación, se incluye una descripción general rápida de los datos sobre el núcleo de Blockly que debes conocer para crear una PR.

  • La rama de trabajo es main y todas las PR deben realizarse en main.
  • Debes completar la plantilla de solicitud de extracción con la información solicitada.
  • El código debe cumplir con la Guía de estilo de TypeScript de Google.
  • Usa commits convencionales en los mensajes de commit y los títulos de las solicitudes de extracción.
  • Las cadenas visibles para el usuario deben estar en el archivo /msg/messages.js para que se puedan traducir. Menos del 6% de la población mundial habla inglés como lengua materna.
  • En general, el texto de los bloques debe estar en minúsculas (al igual que las palabras clave en la mayoría de los lenguajes de programación).
  • Mantener la retrocompatibilidad Hay muchas apps de Blockly, no arruines las de los demás.

  • Todos los archivos de código nuevos deben tener el prefijo de la licencia Apache v2.0:

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

Realiza y verifica un cambio

  1. Ejecuta npm install para instalar las dependencias.
  2. Ejecuta npm run start para iniciar un servidor que ejecute el Playground. Puedes usar esta página para probar el comportamiento existente. Consulta la página de zona de pruebas para obtener más información.
  3. Realiza los cambios necesarios en el código.
  4. Si dejaste el servidor en ejecución, actualiza la página para ver los cambios. De lo contrario, reinicia el servidor y verifica que el código se comporte según lo esperado y que no haya errores ni advertencias en la consola.
  5. Ejecuta npm run build y asegúrate de que no haya errores de compilación.
  6. Escribe pruebas automatizadas. Por lo general, serán pruebas de Mocha en el directorio tests/mocha, pero es posible que te pidamos otros tipos de pruebas.
  7. Ejecuta npm run format para formatear el código y corregir automáticamente algunos problemas de lint.
  8. Ejecuta npm test para ejecutar las pruebas automatizadas. También ejecuta eslint.
  9. Si hay errores de lint, ejecuta npm run lint:fix para corregir los problemas que se pueden corregir automáticamente. Corrige las advertencias o los errores de lint restantes.
  10. Si se superan todas las pruebas, puedes abrir una PR en main con tus cambios.