Muchas gracias por querer colaborar en Pilas Bloques ❤️. Si no lo hiciste todavia leé el README del proyecto para tener una mejor idea de cuál es nuestro objetivo con Pilas Bloques y también instrucciones para instalar el ambiente de desarrollo. En Pilas Bloques trabajamos con Pull Requests, por eso si queres aportar al proyecto vas a tener que forkearlo, hacerte una branch y tirar un PR al repo original. Si no sabés con qué colaborar podés ver los first good issues o bien los proyectos de Github de Pilas Bloques.
Si encontraste un bug y querés reportarlo, o si tenés una idea para un feature para Pilas Bloques, creá un issue describiéndolo.
- El PR tiene que tener el o los issues que resuelve linkeado. Esto se puede hacer escribiendo
Fixes #<Numero de issue>en la descripción del PR. Esto permite que el issue se cierre automáticamente al mergear el PR. - Si el PR incluye cambios visuales se alienta incluír imágenes mostrando el cambio.
- Cada cambio o agregado debe incluír sus tests automatizados, ya sean unitarios o de integración.
- Todos los tests tienen que pasar.
- Todo nuevo código debe estar codificado en inglés. Ver apartado el apartado "Sobre el idioma" de este archivo para saber por qué.
Ejemplo de un buen PR: #147
-
Si querés mejorar o completar una traducción ya existente de Pilas Bloques podés hacerlo buscando el archivo del lenguaje en la carpeta de traducciones y haciendo un pull request con tus cambios propuestos.
-
Si querés empezar la traducción de Pilas Bloques a un lenguaje que todavía no tiene, podés hacerlo creando un nuevo archivo en la carpeta de traducciones y haciendo un pull request con tu traducción propuesta.
Nos podés arrobar acá en Github con @pilasbloqueros o también nos podés mandar un mail a pilasbloques@program.ar
¡¡¡De nuevo muchas gracias por querer colaborar con el proyecto!!! ❤️ ❤️
Pilas Bloques es una aplicación cuya comunidad usuaria y desarrolladora es principalmente hispanohablante. Es por eso que la documentación y discusiones en issues y pull requests están en español.
Sin embargo, viendo la necesidad de recibir aportes de varios lugares del mundo que necesitan también utilizar Pilas Bloques, estamos admitiendo el inglés como idioma secundario en las discusiones, y ya tenemos las primeras versiones en inglés de la documentación.
Pero además, y fundamentalmente, estamos comenzando el proceso de traducción de todo el código al inglés, con el objetivo de ampliar la comunidad. Es por esto que:
- Todo el nuevo código que se proponga en un pull request, debe estar en inglés. 🇬🇧
- Si quien quiere hacer el aporte open source no maneja bien el inglés, el equipo de Pilas Bloques con gusto le ayudará con la traducción. 👍
- Si un pull request modifica extensivamente un componente que estaba codificado en español, se valorarán los esfuerzos por traducir el componente. 🦾