Home - PH-espagnol/borradores GitHub Wiki

¡Bienvenidos a la wiki del repositorio borradores del proyecto Programming Historian en español!

Si has llegado hasta aquí es porque tienes interés en colaborar con nosotros en la creación de la versión en español del sitio The Programming Historian. Muchas gracias por tu colaboración. Aquí hallarás una guía para ayudarte en el proceso de traducción de las lecciones que hayas escogido.

Consideraciones generales para la traducción de lecciones

Antes de proponer o trabajar en la traducción de una lección, te sugerimos revisar la "Lista de traducción." Ahí encontrarás cuáles leciones están ya traducidas, en proceso, asignadas o sin asignar. Si la lección que te interesa trabajar ya está traducida, de todas maneras puedes ayudar a mejorar el texto haciendo tus propuestas de corrección en el "branch" comentarios.
Todas la lecciones se enviarán escritas en editor de texto plano y con marcado Markdown. Puedes ver una introducción a Markdown en Getting Started with Markdown.
La traducción de las lecciones debe ser lo más literal posible y apegadas al original, sin adaptaciones o agregados, en un español neutro (en lo posible). Esto obedece a que las lecciones de PH en inglés están en constante actualización y revisión, por lo que es necesario conservar la misma lógica de exposición para que cualquiera de los editores pueda modificar las traducciones en PH-es.
Para seguir puntualmente la estructura de la lección, tanto en su contenido como en el marcado, lo mejor es partir de la versión en "crudo" de las lecciones del repositorio original, (no de las que están publicadas en el sitio web) de Programming Historian en GitHub. Para ver la versión en "crudo", selecciona el original en inglés de la lección en la que estés trabajando y entonces haz clic en raw.
Copia tal cual el Bloque YAML de la lección original al inicio de tu traducción y agrégale la etiqueta de metadato translator: después de las etiquetas de author y reviewers y, a continuación incluye tu nombre.
Si las lecciones contienen código de programación, es preferible copiarlo a tu traducción tal cual está en el original. Si tienes algunas aptitudes en programación y quieres modificar los nombres de las variables para hacer más legible la lectura del código a los lectores en español, por favor, verifica primero que el código hace lo que tiene que hacer según los autores de la lección. De ninguna manera modifiques el código en una traducción sin antes señalar a los autores que tu propuesta puede funcionar mejor. Todo el código escrito en Python está basado en la versión 2.x (2.7.12 es la verión más actualizada al 7 de octubre de 2016).