470ee07e77
We split the section about pull requests, reducing the steps needed to contribute since there's already a link to help people working on their first pull request, and the rest don't need to be told to fork the repo.
3.6 KiB
Cómo Contribuir a este Proyecto
Código de conducta
Los miembros del proyecto y la comunidad de personas que contribuyen a él se adhieren a un código de conducta que se puede consultar en el archivo CODE_OF_CONDUCT_ES.md.
Comunicación general y de incidencias
El método preferido para informar sobre una incidencia en el proyecto es creando una incidencia en el repositorio del proyecto.
Resolver una incidencia
Las incidencias marcadas como help wanted son funcionalidades bien definidas y que están listas para que quien quiera pueda implementarlas.
Cuando quieras resolver una incidencia mediante código:
- Avisa de que vas a trabajar en esta incidencia añadiendo un comentario.
- Envía una pull request al repositorio principal indicando qué incidencia estás resolviendo y siguiendo nuestras convenciones de código
¿Es tu primer Pull Request? Puedes aprender en este curso gratuito (en inglés) sobre cómo contribuir a un proyecto OpenSource en GitHub
Convenciones de código
Si quieres que revisemos tu código con una sonrisa, por favor sigue nuestras convenciones:
- Incluye tests para los cambios que hayas hecho
- Travis CI comprobará automáticamente que el resto de la aplicación sigue funcionando; asegúrate de que los tests pasan
- Tus cambios serán revisados automáticamente por Hound CI; arregla los problemas de los que informa (si es que hay alguno)
- Sigue las siete reglas para un gran mensaje de commit
Cuando revisemos tu código y te pidamos que cambies alguna cosa, si tienes experiencia con git rebase edita los commits existentes en vez de añadir más. Si no tienes experiencia con git rebase, puedes saltarte este punto.
Otras formas de contribuir sin código
- Si crees que hay una funcionalidad que hace falta, o descubres un problema, abre una incidencia (asegúrate de que no haya una incidencia para lo mismo ya abierta antes)
- También puedes ayudar dando este proyecto a conocer
Cómo escribir una incidencia
- Trata de darle un título descriptivo (algo más que "xxx no funciona").
- Es buena idea incluir las siguientes secciones:
- Pasos que se han realizado para producir la incidencia
- Lo que se esperaba que pasara
- Lo que ha pasado
- También es buena idea que incluyas tu sistema operativo, navegador, versión de navegador y plugins instalados.
¡Gracias! ❤️ ❤️ ❤️
Contribuidores
Miembros del equipo principal
Todos los demás contribuidores
Además del equipo principal, hay más de cien contribuidores. ¡Muchas gracias por vuestro código! También estamos muy agradecidos a las personas que contribuyen de otras formas, incluida la documentación, traducciones, evangelismo, administración de sistemas, comunicación, organización y más.
Finalmente, un agradecimiento especial a los antiguos miembros del equipo principal. Conocidos con cariño como El Alumni:
Juanjo Bazán, Enrique García Cota, Alberto Calderón, María Checa