CONTRIBUTING.md

Pautas de contribución

Bienvenida

Primero que todo, muchas gracias por considerar contribuir con aportes valiosos. Estos proyectos se mantienen activos gracias a sus aportes.

¿Por qué leer estas pautas?

Seguir estas directrices nos ayuda a saber que usted respeta el tiempo de los desarrolladores que administran y mantienen este proyecto de software libre. A cambio, los desarrolladores están comprometidos con abordar el problema, evaluar los cambios y ayudarle a finalizar las solicitudes de extracción.

Reglas generales

• Utilizar únicamente la rama de desarrollo para proponer cambios o mejoras.
• Garantizar la compatibilidad entre plataformas para cada cambio que se acepte. Windows, Mac, Debian, Ubuntu, Linux en general.
• Asegúrese de que el código que entra en el repositorio cumple con las reglas generales de desarrollo para cada lenguaje de programación.
• Seguir o crear problemas (issues) para los cambios y mejoras importantes que desee realizar.
• Tratar las discusiones de forma transparente y obtener comentarios de la comunidad.
• No agregue ninguna clase al código base a menos que sea absolutamente necesario. Debe limitarse al uso de funciones y nunca usar el paradigma de programación orientado a objetos.
• Mantenga los cambios o cambios de características lo más pequeñas posible.

Contribuciones menores

Antes de comenzar directamente con el desarrollo de algunas funcionalidades nuevas, agradeceremos sus aportes con:

• Arreglar un problema (issue)
• Revisar discusiones, alguna mejora o un pull request propuesto por otra persona
• Actualizar documentación de las funciones o del programa en general
• Complementar una página web
• Escribir un tutorial
• Desarrollar ejemplos de aplicación

Colaborar en un proyecto

Para desarrollos mayores a simples arreglos de un par de líneas o correcciones tipográficas, por favor:

• Crear su propia copia del código a partir de la rama "desarrollo" (fork)
• Descargar el código en su computador personal (git clone xxx)
• Crear una rama nueva, cuyo nombre refleje la funcionalidad en la que está trabajando (git checkout -b branch-name)
• Hacer los cambios o desarrollos nuevos
• Poner una etiqueta cuando su desarrollo esté listo (git commit -m "mensaje")
• Actualizar su copia del repositorio en github (git push origin branch-name)
• Pedir una actualización del código principal en github (pull request)