Comienza a contribuir con Blockly

Blockly es de código abierto y está mantenido principalmente por un equipo pequeño. Aceptamos con gusto las contribuciones de desarrolladores ajenos al equipo principal. No podemos compilar todas las funciones solicitadas ni corregir todos los errores informados sin nuestra comunidad. Esta sección contiene guías generales que pueden ser útiles, en especial si es la primera vez que desarrollas software de código abierto.

Para obtener información específica de Blockly que debes leer antes de realizar una contribución, consulta las secciones Cómo contribuir a Core y Cómo contribuir a Samples.

¿Qué repositorio?

Un repositorio contiene todos los archivos de un solo proyecto. Blockly tiene dos repositorios: blockly core y blockly-samples.

Blockly core es el repositorio de la biblioteca de Blockly. Usa este repositorio si quieres realizar un cambio en el comportamiento principal de Blockly de una manera que se aplique a todos los usuarios de la biblioteca.

Blockly samples es el repositorio de muestras, complementos y codelabs. Usa este repositorio si quieres crear o modificar un complemento, escribir un codelab o crear o modificar una muestra.

Paso a paso

Estos son los pasos generales que seguirás cada vez que realices un cambio.

  1. Instala Git y Node siguiendo los vínculos de la sección Herramientas.
  2. Bifurca y clona el repositorio. GitHub tiene un instructivo maravilloso sobre cómo crear una bifurcación de un repo. Para aplicarlo a blockly, simplemente reemplaza cada instancia de octocat/Spoon-Knife por google/blockly o google/blockly-samples, según el repositorio en el que quieras trabajar.
  3. Sincroniza tu bifurcación. GitHub también proporciona un instructivo para sincronizar una bifurcación.
  4. Consulta la rama principal. En Blockly Core, esta es la rama develop. En blockly-samples, esta es la rama master.
  5. Ejecuta npm install en el directorio raíz para instalar dependencias y herramientas de compilación.
  6. Para crear una rama nueva, ejecuta git checkout -b myBranchName en una terminal. El nombre debe ayudarte a recordar en qué estás trabajando.
  7. Realiza los cambios que quieras.
  8. Valida tus cambios, sigue la guía para elementos principales o muestras.
  9. Guarda los cambios con git commit -am "fix: My commit message". Obtén más información sobre los mensajes de confirmación.
  10. Envía tus cambios a GitHub con git push origin myBranchName.
  11. Abre una solicitud de extracción cuando tu código esté listo. Un miembro del equipo de Blockly revisará los cambios y los combinará en Blockly si se aprueban. Para obtener más información, consulta el proceso de revisión de relaciones públicas.