Skip to content

Guía para contribuir con la traducción

Jump to bottom
Tomas-Acs edited this page Mar 24, 2022 · 3 revisions

¡Gracias por el interés en colaborar con esta traducción! Con esta guía queremos ayudarle para que sus aportes pueden llegar al repositorio.

Establecer su ambiente de trabajo para las traducciones

  1. Crear una bifurcación (en inglés fork) del repositorio original. El repositorio original en ese caso será: From-Bias-to-Feminist-AI-Traduccion. Le recomendamos leer la sección Bifurcar un repositorio de la ayuda oficial de Github.

  2. Clone la bifurcación (fork) del repositorio que acaba de crear:

$ git clone [email protected]:<TU-USUARIO>/From-Bias-to-Feminist-AI-Traduccion.git

  1. El comando git clone, ejecutado en el paso anterior, creó una carpeta en su computadora. Ingrese a esta carpeta:

$ cd From-Bias-to-Feminist-AI-Traduccion/

  1. Agrega el repositorio original como «upstream»:

$ git remote add upstream https://github.com/JaquerEspeis/inventar-con-python.git

Con estos 4 pasos ha establecido su ambiente de trabajo. Estos pasos solo deberá hacerlos una vez.

Hacer un aporte

Antes de hacer un aporte, ya sea la traducción de un capítulo nuevo o una mejora de alguno ya traducido, lo ideal es hacer una rama (en inglés branch) nueva. Por ejemplo si va a trabajar en un una mejora al capítulo 2, es decir en el archivo "capitulo2.md", puede hacer una rama nueva como la siguiente:

git checkout -b capitulo2-mejora Seguidamente podrá editar el archivo. Puede utilizar su editor de texto favorito, si no tiene alguno favorito se le sugiere revisar Typora, es liviano y permite combinar el texto en markdown con la visualización correspondiente.

Al finalizar, con el archivo mejorado ya guardado, es momento de subirlo al repositorio original. Para esto puede utilizar los siguientes comandos:

git add capitulo2.md
git commit m 'Mejora de forma y correcciones ortográficas en el capítulo 2.'
git push origin capitulo2-mejora

Si ha modificado más de un archivo entonces debe repetir la primera línea (la del comando git add).

Su aporte ya está en su repositorio, el paso final es solicitar que sea añadido al repositorio de la traducción. Ese se hace en la página web de GitHub. Debe ir a la página de su repositorio y proponer un Pull Request. Revise la sección Acerca de las solicitudes de extracción en la ayuda oficial de GitHub.

Nota: El contenido de esta página está basado en la Guía para contribuir en la traducción del proyecto de traducción al español de la documentación de Python3

Pautas de traducción de libro

Estas pautas deben guiarle en la traducción o revisión de algún capítulo.

El texto está escrito desde una perspectiva femenina, de modo que en ciertos momentos se habla en femenino de las autoras.

La traducción se está haciendo en formato Markdwon, siguiendo el estilo que entiende GitHub. Puede consultar la guía "Mastering Markdown" (en inglés) para comprender este formato.

Si debe crear nuevas imágenes o diagramas que ilustran algunos conceptos o ejemplos del código guárdelos en la capeta images. Utilice como nombre de las imágenes el mismo que tienen en la versión original, en inglés, del libro.

Para agregar notas al pie de página, agregar [^numero de la nota] en donde se requiera y al final del documento se repite de la misma manera [^numero de la nota]: y los apuntes.

Para agregar notas a las imágenes, después de agregar la imagen, agregar este código |:--:| y seguidamente entre | | las notas de las imágenes.

Clone this wiki locally