Sobre esta guía

Para los que deseen colaborar con esta guía así como en su contenido, pueden hacerlo enviandome un correo electronico (eliluminado@codigopython.com.ar), de preferencia en español, o a traves de GitHub desde el canal para envio de fallos o correcciones desde la siguiente url: https://github.com/eliluminado/tutorial_tkinter/issues

Para los mas experimentados pueden colaborar realizando un fork de la guia y luego enviar los cambios entrando en https://github.com/eliluminado/tutorial_tkinter

Workflow

Por hacer

Ampliar contenido

El desarrollo y las correcciones de la guia se realizan sobre la rama develop y se mantiene la rama master unicamente para el contenido que se considere corregido y correcto.

Como recomendacion se agradece chequear que Sphinx no tire errores durante la compilacion, para esto esta tox.

Por hacer

Ampliar contenido sobre uso de tox

Tambien pueden asegurarse de hacerlo antes de hacer un commit modificando o generando el archivo .git/hooks/pre-commit y reemplazar el contenido de este por la siguiente linea

#!/bin/sh

tox

Y para el fichero .git/hooks/pre-push hacemos lo mismo pero con el siguiente codigo.

#!/bin/sh

tox -e linkcheck

Esta recomendacion lo que hace es que despues de que guardes tus cambios con Git te asegures de que Sphinx lo interpreta correctamente y el segundo fichero mostrado evita que subas cambios a GitHub donde hayan links rotos.

Estilos

Las imagenes como captura de los ejemplos mostrados, deben ser preferentemente en formato PNG.

Cuando se coloquen imagenes siempre usar la opcion :alt: de reStructuredText.

Cuando escriban que los renglones no superen los 120 caracteres.

Traducciones

Por hacer

Ampliar contenido