Existen varias maneras de contribuir con la wiki de Python Argentina:
- reportando bugs
- revisando que esos bugs se encuentren vigentes
- etc
No importa como colaboran, siempre se tiene que seguir el Código de Conducta
Cuando se reporte un bug, lo ideal sería que el mismo tenga:
- El link de donde se encuentra el error
- Una captura de pantalla de que es lo que está mal
- Un mensaje describiendo el error que se quiere cambiar
Hay dos formas de proponer mejoras:
- Hacer un cambio en una página puntual desde GitHub.
- Haciendo un Pull Request (PR)
En cualquier caso, siempre es necesario que se creen una cuenta en GitHub
Si no saben mucho de reStructuredText, estos son algunos links que les pueden ayudar:
Si estás viendo una página que está mal, a la derecha del título hay un link a Editar que los va a llevar al código fuente de todas páginas
Una vez en la misma, pueden editarla desde el mismo Github, y cuando commiten los cambios va a pedir crear un PR.
Si tienen que hacer cambios masivos, por ahí usar la interfaz de Github para editar todos los archivos es ineficiente.
En ese caso:
- Tienen que hacer un fork del proyecto
- Clonarse el fork
- Lean el README.rst para saber como configurar el entorno local
- Editar todos los cambios que crean necesarios
- Hacer un PR de su fork al proyecto oficial
Cuando estás editando páginas rST, un par de cosas a tener en cuenta:
- Los nombres de los archivos tienen estar en minúscula y no tener tildes ni otros caracteres especiales
- Los archivos tienen que tener extensión
.rst - Cuando tengan que poner una dirección de mail, no pongan la dirección del mail real, [email protected], sino que usen palabras como dot, at. Por ejemplo: foobar at example dot com