Introducci贸n
Existen varias maneras de contribuir con la wiki de Python Argentina:
revisando que esos bugs se encuentren vigentes
etc
No importa como colaboran, siempre se tiene que seguir el C贸digo de Conducta
Reportanto Bugs
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
Proponiendo una mejora
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
Los contenidos de la wiki pueden ser escritos en Markdown o en reStructeredText. Markdown es muy sencillo de aprender y utilizar pero tiene una sintaxis limitada a diferencia de reStructeredText que permite una mayor configurabilidad.
Si no saben mucho de reStructuredText, estos son algunos links que les pueden ayudar:
Cambio puntual
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.
Cambios masivos
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
Cosas a tener en cuenta
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
.rstCuando tengan que poner una direcci贸n de mail, no pongan la direcci贸n del mail real, foobar@example.com, sino que usen palabras como dot, at. Por ejemplo: foobar at example dot com