Manual del colaborador
Antes de programar, lee las reglas. Así trabajamos juntos en Babelize Elements.
Before you code, read the rules.
Eight rules for contributing to Babelize Elements. Also available as a PDF.
01 · Habla antes de programar
¿Encontraste un error? ¿Tienes una idea? ¿Quieres crear una función? Todavía no empieces a programar.
Evita trabajo duplicado.
Mantén las contribuciones coordinadas.
02 · Abre un PR
Un PR. Un cambio claro. Mantén tu PR:
Enfocado
Resuelve un solo problema. Limita tus cambios a un único issue o función.
Claro
Explica qué cambió y por qué. Añade contexto, capturas de pantalla si hace falta, y enlaza el issue.
Probado
Asegúrate de que tu código funciona como se espera y no rompe la funcionalidad existente.
Revisable
Mantenlo pequeño y limpio. Sin cambios de formato ni refactorizaciones no relacionadas.
Los PR pequeños y enfocados son más fáciles de revisar.
Mantienen el historial limpio y se fusionan más rápido.
03 · Calidad del código
Escribe código que podamos mantener. Antes de abrir tu PR:
Sigue los patrones existentes
Mantén el código coherente con el proyecto.
Mantén los componentes reutilizables
Construye piezas flexibles y componibles.
Usa nombres consistentes
Sigue las convenciones de nombres.
Evita dependencias adicionales
Mantén el proyecto ligero.
Gestiona los casos límite
Piensa en los estados de error y en los escenarios.
Elimina el código no utilizado
Mantén la base de código limpia y mínima.
Prueba tus cambios
Asegúrate de que todo funciona.
Actualiza la documentación cuando sea necesario
Ayuda a otros a entender tus cambios.
¿Nuevo componente? Parte de la plantilla de componente.
Legible > ingenioso.
Escribe código para personas, no solo para máquinas.
04 · Revisión de PR
Un PR no es la meta final.
Los revisores pueden pedir:
Cambios en el código
Refina la implementación o corrige problemas.
Pruebas adicionales
Añade o mejora la cobertura de pruebas.
Actualizaciones de la documentación
Actualiza la documentación, los comentarios o los README.
Aclaración
Aporta más contexto o explicación.
Enfoques diferentes
Debate soluciones alternativas.
Los comentarios forman parte de contribuir.
Sé abierto, responde a tiempo y mantén un tono constructivo.
05 · Normas de la comunidad
Construye con personas, no solo con código.
Sé respetuoso
Trata con respeto a los colaboradores y mantenedores.
Sé constructivo
Señala problemas y ayuda a encontrar soluciones.
Aporta contexto
Explica tu razonamiento.
Ayuda a otros
Comparte lo que sabes.
Mantén el foco
Mantén las discusiones relevantes.
Consulta también nuestro Código de conducta.
El buen código importa.
La buena colaboración también importa.
06 · Estrella y fork
Apoya el proyecto.
Dale una estrella al repo
Una estrella muestra tu apoyo y ayuda a más desarrolladores a descubrir Babelize Elements.
Haz fork del repo
Tu propia copia para experimentar, hacer cambios y abrir PR.
git clone https://github.com/<your-username>/babelize-elements.git
cd babelize-elementsPequeñas acciones. Gran impacto.
Construyamos juntos una internet más inclusiva.
07 · Únete a la comunidad
No construyas solo. Únete al Discord de Babelize y dirígete al canal #elements para:
Preguntas
Haz preguntas y pide ayuda a otros.
Ideas
Comparte ideas y sugerencias.
Contribuciones
Toma issues y contribuye.
Retroalimentación
Ayúdanos a crecer.
Issues
Reporta errores y debate soluciones.
Obtener ayuda
¿Atascado? Pregunta a la comunidad.
Tu contribución empieza con una conversación.
Las ideas crecen más rápido juntas.
08 · Empieza a contribuir
¿Listo para construir?
good first issue.Código abierto. Más personas.
Un futuro más global. Construye con nosotros.