Comienza a contribuir a Blockly

Blockly es de código abierto y está mantenido principalmente por un equipo pequeño. Agradecemos las contribuciones de los desarrolladores externos al equipo principal. No hay manera de que podamos compilar todas las funciones solicitadas o corregir todos los errores informados sin nuestra comunidad. Esta sección contiene guías generales que pueden resultarte útiles, en especial si eres nuevo en el desarrollo de código abierto.

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

¿Qué repositorio?

Un repositorio contiene todos los archivos para 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 realizar un cambio en el comportamiento principal de Blockly de una manera que se aplicará a todos los usuarios de la biblioteca.

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

Paso a paso

Estos son los pasos generales que seguirá cuando realice un cambio.

1. Instala Git y Node. Para ello, sigue los vínculos de la sección Herramientas.
2. Bifurca y clona el repositorio. GitHub tiene un instructivo maravilloso sobre cómo bifurcar un repositorio. Para aplicarlo en bloque, solo reemplaza cada instancia de octocat/Spoon-Knife con google/blockly o google/blockly-samples, según el repositorio en el que desees trabajar.
3. Sincroniza el tenedor. GitHub también proporciona un instructivo para sincronizar una bifurcación.
4. Revisa la rama principal. En el núcleo de bloques, esta es la rama develop. En las muestras de bloques, esta es la rama master.
5. Instala y ejecuta las herramientas mediante la ejecución de npm install en el directorio raíz.
6. Crea una rama nueva ejecutando git checkout -b myBranchName en una terminal. El nombre te ayudará a recordar en qué estás trabajando.
7. Realice los cambios.
8. Valida tus cambios. Sigue la guía para muestras principales o muestras.
9. Guarda tus cambios con git commit -am "fix: My commit message". Obtén más información sobre los mensajes de confirmación.
10. Envía los 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á en Blockly si están aprobados. Para obtener más información, consulta Proceso de revisión de relaciones públicas.