python
diff --git a/‎.gitignore
+1 b/‎.gitignore
+1
diff --git a/‎.overrides/CONTRIBUTING.rst
+1-1 b/‎.overrides/CONTRIBUTING.rst
+1-1
diff --git a/‎.overrides/faq.rst
+33 b/‎.overrides/faq.rst
+33
diff --git a/‎.overrides/reviewers-guide.rst
+35 b/‎.overrides/reviewers-guide.rst
+35
diff --git a/‎.overrides/translation-memory.rst
+7-1 b/‎.overrides/translation-memory.rst
+7-1
diff --git a/‎.travis.yml
+2-1 b/‎.travis.yml
+2-1
diff --git a/‎Makefile
+2-1 b/‎Makefile
+2-1
diff --git a/‎TRANSLATORS
+12 b/‎TRANSLATORS
+12
diff --git a/‎bugs.po
+21-16 b/‎bugs.po
+21-16
diff --git a/‎c-api/bytearray.po
+1-1 b/‎c-api/bytearray.po
+1-1
diff --git a/‎c-api/contextvars.po
+1-1 b/‎c-api/contextvars.po
+1-1
diff --git a/‎c-api/conversion.po
+1-1 b/‎c-api/conversion.po
+1-1
diff --git a/‎c-api/datetime.po
+2-2 b/‎c-api/datetime.po
+2-2
diff --git a/‎c-api/dict.po
+1-1 b/‎c-api/dict.po
+1-1
diff --git a/‎c-api/file.po
+2-2 b/‎c-api/file.po
+2-2
diff --git a/‎c-api/float.po
+1-1 b/‎c-api/float.po
+1-1
diff --git a/‎c-api/gcsupport.po
+1-1 b/‎c-api/gcsupport.po
+1-1
@@ -12,6 +12,7 @@ Doc/CONTRIBUTING.rst
 Doc/translation-memory.rst
 Doc/upgrade-python-version.rst
 locales/
+dict.txt
 
 # Byte-compiled / optimized / DLL files
 __pycache__/
 
@@ -100,7 +100,7 @@ contribución, queremos señalar algunos lineamientos generales.
    .. note::
 
       Si hace tiempo que venis trabajando en una traducción es importante
-      mantener actualizada tu copia local antes de realizar el *Pull Request**
+      :ref:`mantener actualizada <mantener-actualizada>` tu copia local antes de realizar el *Pull Request*.
 
 
 ¿Qué archivo traducir?
 
@@ -61,6 +61,18 @@ Estamos trabajando para unificar el uso de un mismo set de diccionarios de espa
 pero por el momento el chequeo que hacemos es con los diccionarios es_AR y es_ES.
 
 
+¿Cómo agrego una palabra al diccionario?
+----------------------------------------
+
+Si ``pospell`` falla diciendo que no conoce una palabra, pero estamos seguros que esa palabra está bien escrita,
+debemos agregarla al diccionario que ``pospell`` usa internamente para comprobar las palabras.
+
+Para eso debes editar (o crear, si no existe) el archivo ``<archivopo>.txt`` dentro del direcorio ``dictionaries``
+y agregar esa palabra al final de este archivo.
+Nota que debes reemplazar ``<archivopo>`` por el nombre del archivo que estés traduciendo.
+Por ejemplo, si estás traduciendo ``library/decimal.po``, debes editar/crear el archivos ``dictionaries/library_decimal.txt``.
+
+
 ¿Cómo puedo configurar git para manejar correctamente los finales de línea en Windows?
 --------------------------------------------------------------------------------------
 
@@ -177,6 +189,27 @@ Puedes ver el resultado con tu navegador de internet (Firefox, Chrome, etc) ejec
 
 Y luego accediendo a http://localhost:8000/
 
+.. _mantener-actualizada:
+
+¿Cómo actualizar mi copia local del repositorio?
+---------------------------------------------------------
+
+Es recomendable mantener actualizada nuestra copia local para evitar 
+posibles conflictos entre los archivos que trabajamos y la última versión disponible 
+en el repositorio remoto. 
+Primero, necesitamos bajar los cambios de *upstream* (es el nombre que asignamos al 
+repositorio principal de la traducción). Se hace de la siguiente manera::
+
+    git fetch upstream
+
+Luego nos vamos a nuestra rama local, confirmamos e impactamos esos cambios::
+
+    git checkout 3.8
+    git merge upstream/3.8
+    git push origin 3.8 
+
+¡Eso es todo!
+
 
 ¿Tienen una lista de correo?
 ----------------------------
 
@@ -0,0 +1,35 @@
+================================
+Guía para revisar una traducción
+================================
+El costado humano
+=================
+Teniendo en cuenta que todes somos voluntaries en este proyecto, es importante que la forma de comunicarnos sea clara, concisa y amable. Como revisor/a, ayudarás a voluntaries de diferentes culturas y lugares del mundo para que su traducción sea lo más acertada posible y podamos acercar Python a las comunidades de habla hispana. Recuerda que del otro lado de un PR hay una persona que ha dedicado tiempo y esfuerzo; es por eso es la forma en que le des una devolución sobre su trabajo influirá en su actitud hacia el proyecto…¡y en sus ganas de seguir participando de nuestra comunidad!
+Aquí te dejamos algunos *tips* para que tu devolución sea constructiva y genuina:
+
+* Siempre deja un comentario en la PR que deje una conclusión general de tu devolución para dejarle claro a les traductores qué necesita modificación y qué no. Recuerda siempre comenzar reconociendo los aspectos positivos del trabajo de la otra persona y luego puedes agregar comentarios/sugerencias sobre la traducción.
+
+El costado práctico
+===================
+La devolución deberá ser acertada para transmitir el mensaje que necesitamos que llegue; de esta forma, les traductores podrán revisar su trabajo y saber qué necesitan hacer para mejorarlo.
+No olvides que esto se trata de una traducción técnica y como tal, el objetivo es que, básicamente, la persona que la lea pueda entender cómo usar Python. Es por esto que, si bien es importante que la sintaxis sea correcta, el objetivo no es hacer una revisión intensiva del uso del español, a menos que la forma en que se expresó la idea imposibilite que otre la entienda. 
+
+Para esto, Github te ofrece opciones para afrontar una PR (ver botón *Review Changes* arriba a la derecha de los archivos modificados por les traductores):
+* *Comment*: Puedes dejar un comentario sin necesariamente aprobar la PR. Asegúrate de hacerlo con claridad para que quien tradujo sepa que debe modificar algunas cosas antes de que su PR sea aprobada.
+* *Approve*: Dejar esta opción solo para PRs que no necesitan modificación alguna o que solo tengan pocas faltas de ortografía o errores de tipeo, o algún error que no genere un conflicto mayor en la traducción y en su integración al repositorio.
+* *Request Changes*: Utiliza esta opción cuando la traducción necesita varias modificaciones que afectan su integración al repositorio. En este caso también asegúrate de que tu mensaje sea claro y amable para acompañar al traductor en el proceso de modificar y lograr que la PR se apruebe.
+
+*Tips*
+ ====
+* PRs de más de 1000 líneas: Te sugerimos hacer un comentario al principio del PR para indicar hasta qué línea haz hecho el review y qué hay que revisar hasta ese hito.
+* “Needs work” genera en la línea anterior “#fuzzy” para que el traductor revise esa línea. Se puede usar cuando la traducción necesita revisión y en ese momento no puedes sugerir una traducción alternativa.
+
+
+El costado técnico
+==================
+Al revisar una traducción, deberás tener en cuenta ciertos aspectos propios de una traducción técnica de esta índole. Además de que debe entenderse el texto en español y que debes respetar el contenido de la documentación original (ver "A tener en cuenta" en la `Guía para contribuir en la traducción <https://python-docs-es.readthedocs.io/es/3.8/CONTRIBUTING.html>`_), contamos con herramientas en este proyecto que pueden fallar en ciertos casos, y que como revisor/a deberás tener en cuenta.
+
+Cuatro razones por las que puede fallar el *build* de Travis:
+* `powrap` falla
+* `pospell` falla
+* Dict está duplicado
+* Sphinx falla
@@ -63,13 +63,19 @@ Términos y bigramas
 
      key
        clave
+       
+     keyword argument
+       argumento por palabra clave / argumento de palabra clave
 
      handler
        gestor ``tutorial/errors.po``, ``library/functions.po``
 
      handle exception
        Gestionar excepción. ``tutorial/inputoutput.po``
-      
+
+     library
+       biblioteca. ``library/sqlite3.po``
+
      locale
        Configuración regional. ``library/functions.po`` and others
 
 
@@ -10,7 +10,8 @@ install:
   - powrap --version
 script:
   - powrap --check --quiet **/*.po
-  - pospell -p dict -l es_AR -l es_ES **/*.po
+  - cat dict dictionaries/*.txt > dict.txt
+  - pospell -p dict.txt -l es_AR -l es_ES **/*.po
   - make build
 branches:
   only:
 
@@ -89,7 +89,8 @@ progress: venv
 
 .PHONY: spell
 spell: venv
-	$(VENV)/bin/pospell -p dict -l es_ES **/*.po
+	cat dict dictionaries/*.txt > dict.txt
+	$(VENV)/bin/pospell -p dict.txt -l es_ES **/*.po
 
 
 .PHONY: wrap
 
@@ -1,18 +1,25 @@
+Juan Alegría (@zejiran)
+Gabriel Anguita (@gabrielanguita)
 Paula Aragón (@pandrearro)
 Emmanuel Arias (@eamanu)
 Paula Aragón (@pandrearro
 Jhonatan Barrera (@iam3mer)
+Brian Bokser (@brianbok)
 Héctor Canto (@hectorcanto)
 Carlos Crespo (@cacrespo)
 Raúl Cumplido (@raulcd)
 Javier Daza (@javierdaza)
+Juan Diego Alfonso Ocampo (@halcolo)
 Sergio Delgado Quintero (@sdelquin)
 Nicolás Demarchi (@gilgamezh)
 Xavi Francisco (@srxavi)
 Manuel Kaufmann (@humitos)
 Pablo Lobariñas (@Qkolnek)
 Alvar Maciel (@alvarmaciel @amaciel)
+Juan Sebastián Marquez (@juansemarquez)
 Cristián Maureira-Fredes (@cmaureir)
+Cristian Andrés Maximiliano Mayuti (@mayuti)
+Omar Mendo (@beejeke)
 Darwing Medina Lacayo (@darwing1210)
 Claudia Millán Nebot (@clacri @cheshireminima)
 Carlos Joel Delgado Pizarro (@c0x6a)
@@ -25,6 +32,11 @@ Sergio Delgado Quintero (@sdelquin)
 Silvina Tamburini (@silvinabt87)
 David Trigo Chávez (@dtrinf)
 Agustina Quiros (@qagustina)
+María Camila Guerrero Giraldo (@macaguegi)
+José Miguel Hernández Cabrera (@miguelheca)
 María Andrea Vignau (@mavignau @marian-vignau)
 Leonardo Gomez (@gomezgleonardob)
+Luis Sánchez (@LuisAISanchez)
 José Miguel Hernández Cabrera (@miguelheca)
+Naryie Vásquez Martínez (@narvmtz)
+Xavi Rambla Centellas (@xavirambla)
@@ -11,15 +11,16 @@ msgstr ""
 "Project-Id-Version: Python 3.8\n"
 "Report-Msgid-Bugs-To: \n"
 "POT-Creation-Date: 2020-05-05 12:54+0200\n"
-"PO-Revision-Date: 2020-02-23 16:37+0100\n"
+"PO-Revision-Date: 2020-06-28 01:03+0200\n"
 "Last-Translator: \n"
 "Language: es\n"
 "Language-Team: python-doc-es\n"
-"Plural-Forms: nplurals=2; plural=(n != 1)\n"
+"Plural-Forms: nplurals=2; plural=(n != 1);\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=utf-8\n"
 "Content-Transfer-Encoding: 8bit\n"
 "Generated-By: Babel 2.8.0\n"
+"X-Generator: Poedit 2.3.1\n"
 
 #: ../Doc/bugs.rst:5
 msgid "Dealing with Bugs"
@@ -58,7 +59,7 @@ msgid ""
 msgstr ""
 "Si encuentras un error en esta documentación o te gustaría proponer una "
 "mejora, por favor envía un informe de fallos en el :ref:`rastreador <using-"
-"the-tracker>`.  Si tienes una sugerencia en cómo arreglarlo, inclúyela "
+"the-tracker>`.  Si tienes una sugerencia sobre cómo arreglarlo, inclúyela "
 "también."
 
 #: ../Doc/bugs.rst:22
@@ -68,48 +69,53 @@ msgid ""
 "'docs@' is a mailing list run by volunteers; your request will be noticed, "
 "though it may take a while to be processed."
 msgstr ""
-"Si tienes poco tiempo, también puedes enviar un correo con el informe de "
-"errores de documentación a la dirección docs@python.org (los errores de "
-"comportamiento puedes enviarlos a la dirección python-list@python.org). "
-"'docs@' es una lista de e-mail iniciada por voluntarios; tu petición será "
-"notificada, aunque puede que lleve algo de tiempo el ser procesada."
+"Si tienes poco tiempo, también puedes enviar un correo electrónico con el "
+"informe de errores de documentación a la dirección docs@python.org (los "
+"errores de comportamiento puedes enviarlos a la dirección python-list@python."
+"org). 'docs@' es una lista de correo iniciada por voluntarios; tu petición "
+"será notificada, aunque puede que lleve algo de tiempo el ser procesada."
 
 #: ../Doc/bugs.rst:30
-#, fuzzy
 msgid "`Documentation bugs`_"
-msgstr "Documentación de errores"
+msgstr "`Documentación de errores`_"
 
 #: ../Doc/bugs.rst:30
-#, fuzzy
 msgid ""
 "A list of documentation bugs that have been submitted to the Python issue "
 "tracker."
-msgstr "`Documentación de errores`_ en el rastreador de problemas de Python"
+msgstr ""
+"Una lista de errores (*bugs*) que ha sido enviada al issue tracker (sistema "
+"de seguimiento de incidentes) de Python."
 
 #: ../Doc/bugs.rst:33
 msgid "`Issue Tracking <https://devguide.python.org/tracker/>`_"
-msgstr ""
+msgstr "`Seguimiento de incidencias <https://devguide.python.org/tracker/>`_"
 
 #: ../Doc/bugs.rst:33
 msgid ""
 "Overview of the process involved in reporting an improvement on the tracker."
 msgstr ""
+"Resumen general del proceso necesario para reportar una mejora en el tracker."
 
 #: ../Doc/bugs.rst:35
 msgid ""
 "`Helping with Documentation <https://devguide.python.org/docquality/#helping-"
 "with-documentation>`_"
 msgstr ""
+"`Ayudar con la documentación <https://devguide.python.org/docquality/"
+"#helping-with-documentation>`_"
 
 #: ../Doc/bugs.rst:36
 msgid ""
 "Comprehensive guide for individuals that are interested in contributing to "
 "Python documentation."
 msgstr ""
+"Guía detallada para gente interesada en contribuir a la documentación de "
+"Python."
 
 #: ../Doc/bugs.rst:41
 msgid "Using the Python issue tracker"
-msgstr "Utilizar el rastreador de problemas de Python"
+msgstr "Utilizar el issue tracker de Python"
 
 #: ../Doc/bugs.rst:43
 msgid ""
@@ -186,7 +192,7 @@ msgstr ""
 "En el campo \"Comment\", describe el problema con detalle, incluyendo qué "
 "esperabas que ocurriera y que ha sucedido en realidad. Asegúrate de incluir "
 "si cualquier módulo de extensión está involucrado, y qué plataformas de "
-"harware y software estás usando (incluyendo las versiones correspondientes)."
+"hardware y software estás usando (incluyendo las versiones correspondientes)."
 
 #: ../Doc/bugs.rst:72
 msgid ""
@@ -215,7 +221,6 @@ msgstr ""
 "tipo de información es útil y por qué lo es."
 
 #: ../Doc/bugs.rst:84
-#, fuzzy
 msgid ""
 "`Bug Report Writing Guidelines <https://developer.mozilla.org/en-US/docs/"
 "Mozilla/QA/Bug_writing_guidelines>`_"
 
@@ -79,7 +79,7 @@ msgid ""
 "failure, ``NULL`` is returned."
 msgstr ""
 "Crea un nuevo objeto de arreglo de bytes a partir de *string* y su longitud, "
-"*len*. En caso de fallo, se devuelve ``NULL``."
+"*len*. En caso de fallo, se retorna ``NULL``."
 
 #: ../Doc/c-api/bytearray.rst:56
 msgid ""
 
@@ -174,7 +174,7 @@ msgstr ""
 "Crea un nuevo objeto ``ContextVar``. El parámetro *name* se usa para "
 "propósitos de introspección y depuración. El parámetro *def* puede "
 "especificar opcionalmente el valor predeterminado para la variable de "
-"contexto. Si se ha producido un error, esta función devuelve ``NULL``."
+"contexto. Si se ha producido un error, esta función retorna ``NULL``."
 
 #: ../Doc/c-api/contextvars.rst:121
 msgid ""
 
@@ -277,7 +277,7 @@ msgid ""
 msgstr ""
 "El valor de retorno es un puntero a *buffer* con la cadena de caracteres "
 "convertida o ``NULL`` si la conversión falla. La persona que llama es "
-"responsable de liberar la cadena de caracteres devuelta llamando a :c:func:"
+"responsable de liberar la cadena de caracteres retornada llamando a :c:func:"
 "`PyMem_Free`."
 
 # case insensitive
 
@@ -303,13 +303,13 @@ msgid ""
 "Create and return a new :class:`datetime.datetime` object given an argument "
 "tuple suitable for passing to :meth:`datetime.datetime.fromtimestamp()`."
 msgstr ""
-"Crea y devuelve un nuevo objeto :class:`datetime.datetime` dado una tupla de "
+"Crea y retorna un nuevo objeto :class:`datetime.datetime` dado una tupla de "
 "argumentos adecuada para pasar a :meth:`datetime.datetime.fromtimestamp()`."
 
 #: ../Doc/c-api/datetime.rst:248
 msgid ""
 "Create and return a new :class:`datetime.date` object given an argument "
 "tuple suitable for passing to :meth:`datetime.date.fromtimestamp()`."
 msgstr ""
-"Crea y devuelve un nuevo objeto :class:`datetime.date` dado una tupla de "
+"Crea y retorna un nuevo objeto :class:`datetime.date` dado una tupla de "
 "argumentos adecuada para pasar a :meth:`datetime.date.fromtimestamp()`."
@@ -250,7 +250,7 @@ msgstr ""
 "verdadero para cada par en el diccionario y falso una vez que todos los "
 "pares han sido reportados. Los parámetros *pkey* y *pvalue* deben apuntar a :"
 "c:type:`PyObject\\*` variables que se completarán con cada clave y valor, "
-"respectivamente, o pueden ser ``NULL``. Cualquier referencia devuelta a "
+"respectivamente, o pueden ser ``NULL``. Cualquier referencia retornada a "
 "través de ellos es prestada. *ppos* no debe modificarse durante la "
 "iteración. Su valor representa desplazamientos dentro de la estructura "
 "interna del diccionario, y dado que la estructura es escasa, los "
 
@@ -89,7 +89,7 @@ msgid ""
 "and returns ``-1`` on failure."
 msgstr ""
 "Retorna el descriptor de archivo asociado con *p* como :c:type:`int`. Si el "
-"objeto es un entero, se devuelve su valor. Si no, se llama al método :meth:"
+"objeto es un entero, se retorna su valor. Si no, se llama al método :meth:"
 "`~io.IOBase.fileno` del objeto si existe; el método debe devolver un número "
 "entero, que se retorna como el valor del descriptor de archivo. Establece "
 "una excepción y retorna ``-1`` en caso de error."
@@ -161,7 +161,7 @@ msgid ""
 msgstr ""
 "Una vez que se ha establecido un *hook*, no se puede quitar ni reemplazar, y "
 "luego llamadas a :c:func:`PyFile_SetOpenCodeHook` fallarán. En caso de "
-"error, la función devuelve -1 y establece una excepción si el intérprete se "
+"error, la función retorna -1 y establece una excepción si el intérprete se "
 "ha inicializado."
 
 #: ../Doc/c-api/file.rst:83
 
@@ -86,7 +86,7 @@ msgstr ""
 "*pyfloat*. Si *pyfloat* no es un objeto de punto flotante de Python pero "
 "tiene un método :meth:`__float__`, primero se llamará a este método para "
 "convertir *pyfloat* en un flotante. Si ``__float __()`` no está definido, "
-"entonces recurre a :meth:`__index__`. Este método devuelve ``-1.0`` en caso "
+"entonces recurre a :meth:`__index__`. Este método retorna ``-1.0`` en caso "
 "de falla, por lo que se debe llamar a :c:func:`PyErr_Occurred` para "
 "verificar si hay errores."
 
 
@@ -229,7 +229,7 @@ msgstr ""
 "llamar a la función *visit* para cada objeto directamente contenido por "
 "*self*, siendo los parámetros a *visit* el objeto contenido y el valor *arg* "
 "pasado al controlador. La función *visit* no debe llamarse con un argumento "
-"de objeto ``NULL``. Si *visit* devuelve un valor distinto de cero, ese valor "
+"de objeto ``NULL``. Si *visit* retorna un valor distinto de cero, ese valor "
 "debe devolverse inmediatamente."
 
 #: ../Doc/c-api/gcsupport.rst:117