Merge remote-tracking branch 'upstream/3.8' into 3.8

MiguelHeCa · MiguelHeCa · commit f2ccc39a0e1a · 2020-05-25T23:10:20.000+02:00
diff --git a/.overrides/CONTRIBUTING.rst b/.overrides/CONTRIBUTING.rst
@@ -1,53 +1,56 @@
 :orphan:
 
-Guía para contribuir en la traducción 
+Guía para contribuir en la traducción
 =====================================
 
 ¡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. Te damos la bienvenida y 
-te agradecemos anticipadamente por tus futuras colaboraciones.  
+para poder seguir adelante con este proyecto. Te damos la bienvenida y
+te agradecemos anticipadamente por tus futuras colaboraciones.
 
 Este es el grupo de trabajo para la traducción de la
 documentación oficial de Python al Español, todo el contenido de la traducción
-es mantenido por voluntaries que aportan su tiempo y trabajo a la comunidad. 
+es mantenido por voluntaries que aportan su tiempo y trabajo a la comunidad.
 
-Antes de comenzar tu primera traducción y que sigas con esta guia de
-contribución queremos señalar algunos lineamientos generales. 
+Antes de comenzar tu primera traducción, y que sigas con esta guia de
+contribución, queremos señalar algunos lineamientos generales.
 
 - Esta traducción es mantenida por personas de todo el mundo que hablan el
   idioma Español. No queremos atarla a ninguna región en particular y creemos
   que es un valor extra la diversidad de la misma.  Vas a encontrar secciones
   con diferentes tonalidades de países, regiones o estilos. Lo único que pedimos
   es consistencia dentro de un mismo módulo o sección (es decir no cambiar de
-  estilo de un párrafo a otro por ejemplo) y siempre intentar que la persona del
+  estilo de un párrafo a otro, por ejemplo) y siempre intentar que la persona del
   otro lado pueda entender lo que estamos escribiendo (no usar lunfardo o
-  regionalismos muy propios de un único lugar) 
+  regionalismos muy propios de un único lugar).
 
-- La documentación es ENORME, cualquier traba que encuentres siempre puedes 
-  marcar el texto como “fuzzy” o para revisar en el futuro. 
-  No pierdas horas buscando la palabra perfecta.  
+- La documentación es ENORME, cualquier traba que encuentres siempre puedes
+  marcar el texto como “fuzzy” o para revisar en el futuro.
+  No pierdas horas buscando la palabra perfecta.
 
 - En muchos casos el mejor criterio es pensar en el vocabulario que utilizamos
   cuando le explicamos a otra persona, o en el trabajo. En muchas ocasiones la
   versión en inglés o “spanglish” de la palabra es mucho mejor que decir “git
   unir” (para git merge).
 
-- Siempre vas a tener un review de lo que propongas y en ese intercambio otras 
-  personas van a ayudarte a destrabar las dudas que tengas.  
+- Siempre vas a tener un review de lo que propongas y en ese intercambio otras
+  personas van a ayudarte a destrabar las dudas que tengas.
 
 - Colaborar haciendo reviews también es muy muy importante, así que si
   tienes un rato libre puedes comenzar por mirar los PRs pendientes de revisar.
 
 - Último pero no menos importante, divertite y contá con la ayuda de todes. Te
-  esperamos en nuestro chat en telegram. Gracias! 
+  esperamos en nuestro chat en telegram. ¡Gracias!
 
 
 .. note::
 
    Si tienes cualquier duda, puedes enviarnos un email a docs-es@python.org.
 
 
+¡Comienza a traducir!
+---------------------
+
 #. Crea un fork del repositorio_.
 
    .. note::
@@ -95,76 +98,68 @@ contribución queremos señalar algunos lineamientos generales.
    (así se cierra automáticamente cuando se hace *merge*)
 
 
-¿Qué archivo traducir?  
+¿Qué archivo traducir?
 ----------------------
 
 Tenemos una `lista de issues en GitHub`_ en dónde vamos coordinando el trabajo
 realizado para no traducir dos veces lo mismo.  El proceso para traducir un
 archivo es el siguiente:
 
 
-#. Elige cualquier de los que *no están asignados* a otra persona.  #. Deja un
-   comentario en el issue diciendo que quieres trabajar en él.  #. Espera a que
-   un administrador te asigne el issue.  #. ¡Empieza a traducir!
+#. Elige cualquier de los que *no están asignados* a otra persona.
+#. Deja un comentario en el issue diciendo que quieres trabajar en él.
+#. Espera a que un administrador te asigne el issue.
+#. ¡Empieza a traducir!
 
 
 
-A tener en cuenta 
+A tener en cuenta
 -----------------
 
-* No debes traducir el contenido de ``:ref:...`` y ``:term:...``.  * Si tienes
-  que usar palabras en inglés debes ponerlas en *italics* (rodeadas por
-  asteriscos) * Puedes revisar las :doc:`faq` para leer sobre problemas
-  conocidos.  * Si traduces un título que es un link, por favor traduce el link
-  también (por ejemplo un artículo a Wikipedia).  En caso de que no haya una
-  traducción del artículo en Wikipedia deja el título sin traducir.  * Tenemos
-  una `Memoria de Traducción`_, que usamos para tener consistencia con algunos
-  términos.  * Si tienes una duda sobre una palabra o término, escríbelo como
-  mejor suene para vos y marca ese párrafo como "Need work" / "Necesita trabajo"
-  en *poedit*.  Además, escribe un comentario explicando cuál es el termino en
-  ese párrafo con el que no estabas segura.  * Puedes usar `la traducción al
-  Portugués`_ para ver cómo ellos hicieron la traducción de alguna palabra.  *
-  Wikipedia puede ser útil también. Busca la palabra en Inglés, y luego mira si
-  tiene una traducción al Español en la barra de la izquierda. Suelen estar
-  bastante bien explicados.
+* No debes traducir el contenido de ``:ref:...`` y ``:term:...``.
 
+* Si tienes que usar palabras en inglés debes ponerlas en *italics* (rodeadas
+  por asteriscos)
 
-.. note::
+* Puedes revisar las :doc:`faq` para leer sobre problemas conocidos.
 
-   También puedes unirte a `nuestro canal de Telegram`_ si necesitas ayuda.
+* Si traduces un título que es un link, por favor traduce el link también (por
+  ejemplo un artículo a Wikipedia). En caso de que no haya una traducción del
+  artículo en Wikipedia deja el título sin traducir.
 
+* Tenemos una `Memoria de Traducción`_, que usamos para tener consistencia con
+  algunos términos.
 
-Previsualizar los cambios 
--------------------------
+* Si tienes una duda sobre una palabra o término, escríbelo como mejor suene
+  para vos y marca ese párrafo como "Need work" / "Necesita trabajo" en
+  *poedit*. Además, escribe un comentario explicando cuál es el termino en ese
+  párrafo con el que no estabas segura.
 
-Hay dos formas de visualizar, junto con el resultado final de la documentación,
-los cambios que has hecho.
+* Puedes usar `la traducción al Portugués`_ para ver cómo ellos hicieron la
+  traducción de alguna palabra.
 
-Read the Docs 
-`````````````
+* Wikipedia puede ser útil también. Busca la palabra en Inglés, y luego mira si
+  tiene una traducción al Español en la barra de la izquierda. Suelen estar
+  bastante bien explicados.
 
-Una vez que hayas hecho un Pull Request en GitHub, este mostrará al final de
-página una sección de "check".  Allí debería haber uno que diga
-``docs/readthedocs.org:python-docs-es`` y al lado un link de "Details".
 
-Haciendo click en ese link verás una versión de la documentación con tus
-cambios.
+.. note::
 
-Construcción local 
-``````````````````
+   También puedes unirte a `nuestro canal de Telegram`_ si necesitas ayuda.
 
-Desde el mismo directorio ``python-docs-es/`` que se creó cuando hiciste ``git
-clone`` puedes ejecutar::
 
-  make build
+Previsualizar los cambios
+-------------------------
 
-Este comando demorará unos minutos y generará toda la documentación en formato
-HTML en tu computadora.  Puedes ver el resultado con tu navegador de internet
-(Firefox, Chrome, etc) ejecutando::
+Una vez que hayas hecho un *Pull Request* en GitHub, este mostrará al final de página una sección de "check".
+Allí debería haber uno que diga ``docs/readthedocs.org:python-docs-es`` y al lado un link de "Details".
 
-  make serve
+.. figure:: readthedocs-preview.png
+   :width: 85%
+   :align: center
 
-Y luego accediendo a http://localhost:8000/
+Haciendo click en ese link verás una versión de la documentación completa que incluirá todos tus cambios.
+Tendrás que navegar hasta el archivo que hayas cambiado para ver cómo se visualiza luego del build.
 
 
 .. _repositorio: https://github.com/python/python-docs-es
diff --git a/.overrides/faq.rst b/.overrides/faq.rst
@@ -150,3 +150,33 @@ Luego, cada vez que realices un commit se ejecutará ``pre-commit`` y validará
 
    Si por cualquier motivo no está funcionando ``pre-commit`` y no te deja hacer *push* de tus cambios,
    lo puedes desinstalar simplemente mediante: ``pre-commit uninstall``.
+
+
+¿Cómo puedo hacer un *build* local de la documentación?
+-------------------------------------------------------
+
+.. note::
+
+   Necesitas un poco de conocimiento para instalar ``make`` en tu sistema operativo.
+
+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 con tu navegador de internet (Firefox, Chrome, etc) ejecutando::
+
+  make serve
+
+Y luego accediendo a http://localhost:8000/
+
+
+¿Tienen una lista de correo?
+----------------------------
+
+Sí.
+
+No tiene mucho tráfico aún ya que estamos usando más el canal de Telegram por el momento.
+Puedes suscribirte ingresando aquí_.
+
+.. _aquí: https://mail.python.org/mailman3/lists/docs-es.python.org/
diff --git a/.overrides/readthedocs-preview.png b/.overrides/readthedocs-preview.png
diff --git a/TRANSLATORS b/TRANSLATORS
@@ -9,6 +9,7 @@ Carlos Joel Delgado Pizarro (@c0x6a)
 Nicolás Demarchi (@gilgamezh)
 Xavi Francisco (@srxavi)
 Manuel Kaufmann (@humitos)
+Alvar Maciel (@alvarmaciel @amaciel)
 Cristián Maureira-Fredes (@cmaureir)
 Claudia Millán Nebot (@clacri @cheshireminima)
 María José Molina Contreras (@mjmolina)
diff --git a/dict b/dict
@@ -45,6 +45,8 @@ Henstridge
 Hewlett
 Hugunin
 I
+Identación
+Idiomático
 Index
 Inf
 Interesantemente
@@ -72,6 +74,7 @@ N
 NaN
 NumPy
 Numerical
+Octales
 Olsen
 POSIX
 POST
@@ -92,6 +95,8 @@ Python
 Pythónico
 Qt
 Randal
+Refactorizados
+Refactorizar
 redireccionamiento
 Reilly
 Rezinsky
@@ -102,6 +107,7 @@ Schwartz
 SciPy
 SimpleFileExFlags
 Smalltalk
+Sobreescriben
 Solaris
 Spot
 Stein
@@ -136,6 +142,7 @@ autocompletado
 autodocumentada
 b
 backspace
+backtick
 bash
 batch
 bdist
@@ -146,6 +153,7 @@ booleanos
 buffer
 bug
 built
+builtins
 build
 byte
 bytecode
@@ -195,6 +203,7 @@ desasignarán
 desasignador
 desasignadores
 descompresor
+desempaquetamiento
 deserializar
 desinstalador
 designadores
@@ -212,7 +221,6 @@ enrutamiento
 entendible
 enumerador
 env
-ésimo
 especificador
 especificadores
 estáticamente
@@ -232,6 +240,8 @@ formateador
 formateadores
 fraccional
 freeze
+from
+future
 garbage
 gcc
 gid
@@ -243,7 +253,9 @@ hash
 hashables
 host
 i
+identación
 idiomáticas
+idiomático
 if
 implementación
 implementaciones
@@ -285,6 +297,7 @@ interoperabilidad
 intérpreter
 invocable
 invocables
+isinstance
 iterador
 iteradores
 j
@@ -303,6 +316,7 @@ manejador
 manejadores
 manifesto
 mantenibilidad
+map
 mapear
 mapeo
 mapeos
@@ -339,6 +353,7 @@ mxBase
 naíf
 naífs
 ncurses
+octales
 normalización
 operando
 onexit
@@ -365,6 +380,7 @@ post
 posteriori
 precompilado
 predeclarando
+print
 preinstalar
 presumiblemente
 proléptico
@@ -398,6 +414,8 @@ redimensionables
 redondeándolo
 ref
 refactorización
+refactorizados
+refactorizar
 referenciable
 referenciables
 referenciada
@@ -409,7 +427,9 @@ referenciarse
 reinicializador
 reinicializar
 remove
+renombramiento
 reordenar
+repr
 request
 root
 reubicar
@@ -436,6 +456,7 @@ sintácticamente
 situ
 sobreescriban
 sobreescribe
+sobreescriben
 socket
 sockets
 solucionadores
@@ -495,6 +516,7 @@ vía
 Win
 wchar
 web
+while
 widget
 widgets
 wiki
@@ -507,3 +529,4 @@ ydel
 zip
 zipimporter
 zlib
+ésimo
diff --git a/library/2to3.po b/library/2to3.po
