Por favor: tome en cuenta que este repoitorio dejó de estar activo desde principios del año 2017 dado que integramos su contenido y los procesos al repositorio de The Programming Historian
Borradores de traducciones PH-es para editar / PH translation drafts before submit to programminghistorian/ph-submissions
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 lecciones 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. Por ejemplo: “Todo el código escrito en Python está basado en la versión 2.x (2.7.12 es la versión más actualizada al 7 de octubre de 2016)”.