Update CONTRIBUTING.rst guide

python · humitos · May 3, 2020 · May 3, 2020 · May 3, 2020 · May 3, 2020
commit 0e93e340e71b57af0ad33e574eff1685e7ff13d3
diff --git a/CONTRIBUTING.rst b/CONTRIBUTING.rst
@@ -1,38 +1,98 @@
-Guía para contribuir en la documentación utilizando Github
-===========================================================
+Guía para contribuir en la traducción
+=====================================
 
-Crea un fork y clona el repositorio 
------------------------------------ 
+¡Muchas gracias por tu interés en participar de la traducción de la documentación oficial de Python al Español!
+Necesitamos *mucho* de tu ayuda para poder seguir adelante con este proyecto.
 
-https://help.github.com/en/github/getting-started-with-github/fork-a-repo
+Actualmente se puede colaborar utilizando una de las dos siguientes formas que:
 
-Luego de tener un fork clonalo en tu maquina
+#. Utilizando el repositorio de GitHub y el editor poedit_
+#. Realizando traducciones directamente en Transifex
 
-.. code-block:: bash
 
-    # Git clone your github fork using ssh (replace raulcd):
-    # Clona el repositorio en tu maquina ejecutando
-    git@github.com:<TU_USUARIO>/python-docs-es.git
+.. note::
 
-    # Ingresá al nuevo directorio con el repo 
-    cd python-docs-es/
+   Si tienes cualquier duda, puedes enviarnos un email a docs-es@python.org.
 
-    # Agregá el repositorio original como upstream.
-    git remote add upstream https://github.com/raulcd/python-docs-es.git
 
+Desde GitHub
+------------
 
-Crear un build local 
---------------------
+#. Crea un fork del repositorio.
+
+   .. note::
+
+      Puedes consular la `ayuda oficial de GitHub`_, si lo deseas.
+
+      .. _ayuda oficial de GitHub: https://help.github.com/es/github/getting-started-with-github/fork-a-repo
+
+#. Clona el repositorio::
+
+   git clone git@github.com:<TU-USUARIO>/python-docs-es.git
+
+#. Ingresa en la carpeta que `git clone` creó en tu computadora::
+
+   cd python-docs-es/
+
+#. Agrega el repositorio original como "upstream"::
+
+   git remote add upstream https://github.com/pycampes/python-docs-es.git
+
+#. Instala las herramientas de `pre-commit` (opcional)::
+
+   pip install pre-commit
+   pre-commit install
+
+#. Mira que archivo necesita ser traducido. El siguiente comando te mostrará una lista de archivos y los porcentajes traducidos.
+   Elige uno que no esté completo::
+
+     make progress
+
+#. Una vez que hayas elegido el archivo, lo puedes abrir con el editor poedit_ y empezar a traducir.
+
+#. Cuando hayas terminado tu sesión, debes guardar tus cambios y enviarlos a GitHub de nuevo::
 
-Hay un script para automatizar estos pasos el mismo va a:
+   git commit -am 'Traducido archivo {nombre de archivo}'
+   git push origin update-translation
 
-- Crear un virtualenv dentro del directorio del repositorio e instalar en el mismo las librearias necesarias
-- Clonar el repositorio oficial de cpython para construir ("biuldear") la documentación. 
+#. Luego ve a tu página de GitHub y propone hacer un Pull Request
 
-.. code-block:: bash
+   .. note::
 
-   make build 
+      Puedes consultar la `ayuda oficial de GitHub para crear un Pull Request`_ si lo deseas.
+
+      .. _ayuda oficial de GitHub para crear un Pull Request: https://help.github.com/es/github/collaborating-with-issues-and-pull-requests/about-pull-requests
+
+
+.. _poedit: https://poedit.net/
+
+
+
+Previsualizar los cambios
+~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Hay dos formas de visualizar, junto con el resultado final de la documentación, los cambios que has hecho.
+
+Read the Docs
+`````````````
+
+Una vez que hayas hecho un Pull Request en GitHub, este mostrará al final de página una sección de "check".
+Ahí, debería haber uno que diga `docs/readthedocs.org:python-docs-es`, y al lado un link de "Details".
+Haciendo click en ese link, deberías poder ver una versión de la documentación con tus cambios.
+
+Construcción local
+``````````````````
+
+Desde el mismo directorio `python-docs-es/` que se creó cuando hiciste `git clone`, puedes ejecutar::
+
+  make build
+
+Este comando demorará unos minutos y generará toda la documentación en formato HTML en tu computadora.
+Puedes ver el resultado abriendo el archivo `venv/workdirs/cpython/Doc/build/html/index.html`
+con tu navegador de internet (Firefox, Chrome, etc).
+
+
+Utilizando Transifex
+--------------------
 
-   # luego para poder ver la documentación ejecuta el siguiente comando y podes luego ir a http://localhost:8000 para ver la documentación 
-   # recién construida.
-   make serve 
+ToDo.