Comienza a contribuir con Blockly

Blockly es de código abierto y lo mantiene principalmente un equipo pequeño. Agradecemos las contribuciones de los desarrolladores que no forman parte del equipo principal, ya que no podemos crear todas las funciones solicitadas ni corregir todos los errores informados sin nuestra comunidad. En esta sección, se incluyen guías generales que pueden resultarte útiles, en especial si no tienes experiencia en el desarrollo de código abierto.

Para obtener información específica sobre Blockly que debes leer antes de hacer una contribución, consulta las secciones Cómo contribuir al núcleo y Cómo contribuir a las muestras.

¿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 deseas cambiar 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 excelente sobre cómo bifurcar un repo. Para aplicarlo a Blockly, solo reemplaza cada instancia de octocat/Spoon-Knife por RaspberryPiFoundation/blockly o RaspberryPiFoundation/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 el núcleo de Blockly, esta es la rama develop. En blockly-samples, esta es la rama master.
  5. Ejecuta npm install en el directorio raíz para instalar las dependencias y las herramientas de compilación.
  6. Ejecuta git checkout -b myBranchName en una terminal para crear una rama nueva. El nombre debe ayudarte a recordar en qué estás trabajando.
  7. Realiza los cambios.
  8. Valida tus cambios siguiendo la guía para núcleos 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á tus cambios y los combinará con Blockly si se aprueban. Para obtener más información, consulta Proceso de revisión de la PR.