python
diff --git a/‎.gitignore
+1 b/‎.gitignore
+1
diff --git a/‎.overrides/faq.rst
+12 b/‎.overrides/faq.rst
+12
diff --git a/‎.overrides/reviewers-guide.rst
+35 b/‎.overrides/reviewers-guide.rst
+35
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
+3-1 b/‎TRANSLATORS
+3-1
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
diff --git a/‎c-api/init.po
+3-3 b/‎c-api/init.po
+3-3
diff --git a/‎c-api/intro.po
+1-1 b/‎c-api/intro.po
+1-1
diff --git a/‎c-api/iterator.po
+3-3 b/‎c-api/iterator.po
+3-3
diff --git a/‎c-api/mapping.po
+1-1 b/‎c-api/mapping.po
+1-1
diff --git a/‎c-api/number.po
+1-1 b/‎c-api/number.po
+1-1
diff --git a/‎c-api/objbuffer.po
+4-5 b/‎c-api/objbuffer.po
+4-5
diff --git a/‎c-api/sequence.po
+1-1 b/‎c-api/sequence.po
+1-1
diff --git a/‎c-api/set.po
+1-1 b/‎c-api/set.po
+1-1
diff --git a/‎c-api/sys.po
+1-1 b/‎c-api/sys.po
+1-1
diff --git a/‎c-api/tuple.po
+1-1 b/‎c-api/tuple.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__/
 
@@ -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?
 --------------------------------------------------------------------------------------
 
 
@@ -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
@@ -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
 
@@ -9,12 +9,14 @@ 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)
@@ -38,4 +40,4 @@ Leonardo Gomez (@gomezgleonardob)
 Luis Sánchez (@LuisAISanchez)
 José Miguel Hernández Cabrera (@miguelheca)
 Naryie Vásquez Martínez (@narvmtz)
-Xavi Rambla Centellas (@xavirambla)
+Xavi Rambla Centellas (@xavirambla)
@@ -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
 
@@ -1803,7 +1803,7 @@ msgstr ""
 "información de estado específica del hilo. Cada extensión debe usar una "
 "clave única para almacenar el estado en el diccionario. Está bien llamar a "
 "esta función cuando no hay un estado del hilo actual disponible. Si esta "
-"función devuelve ``NULL``, no se ha producido ninguna excepción y la persona "
+"función retorna ``NULL``, no se ha producido ninguna excepción y la persona "
 "que llama debe asumir que no hay disponible ningún estado del hilo actual."
 
 #: ../Doc/c-api/init.rst:1090
@@ -2001,7 +2001,7 @@ msgstr ""
 "subinterprete. Este estado de hilo se realiza en el estado de hilo actual. "
 "Tenga en cuenta que no se crea ningún hilo real; vea la discusión de los "
 "estados del hilo a continuación. Si la creación del nuevo intérprete no "
-"tiene éxito, se devuelve ``NULL``; no se establece ninguna excepción, ya que "
+"tiene éxito, se retorna ``NULL``; no se establece ninguna excepción, ya que "
 "el estado de excepción se almacena en el estado actual del hilo y es posible "
 "que no haya un estado actual del hilo. (Al igual que todas las otras "
 "funciones de Python/C API, el bloqueo global del intérprete debe mantenerse "
@@ -2319,7 +2319,7 @@ msgstr ":const:`PyTrace_RETURN`"
 msgid ""
 "Value being returned to the caller, or ``NULL`` if caused by an exception."
 msgstr ""
-"Valor devuelto al que llama, o ``NULL`` si es causado por una excepción."
+"Valor retornado al que llama, o ``NULL`` si es causado por una excepción."
 
 #: ../Doc/c-api/init.rst:1382
 msgid ":const:`PyTrace_C_CALL`"
 
@@ -694,7 +694,7 @@ msgstr ""
 "tanto, si extrae un elemento de una lista usando :c:func:`PyList_GetItem`, "
 "no posee la referencia --- pero si obtiene el mismo elemento de la misma "
 "lista usando :c:func:`PySequence_GetItem` (que toma exactamente los mismos "
-"argumentos), usted posee una referencia al objeto devuelto."
+"argumentos), usted posee una referencia al objeto retornado."
 
 #: ../Doc/c-api/intro.rst:418
 msgid ""
 
@@ -35,15 +35,15 @@ msgstr ""
 "un iterador de secuencia, funciona con una secuencia arbitraria que admite "
 "el método :meth:`__getitem__`. El segundo funciona con un objeto invocable y "
 "un valor centinela, llamando al invocable para cada elemento de la secuencia "
-"y finalizando la iteración cuando se devuelve el valor centinela."
+"y finalizando la iteración cuando se retorna el valor centinela."
 
 #: ../Doc/c-api/iterator.rst:17
 msgid ""
 "Type object for iterator objects returned by :c:func:`PySeqIter_New` and the "
 "one-argument form of the :func:`iter` built-in function for built-in "
 "sequence types."
 msgstr ""
-"Objeto tipo para objetos iteradores devueltos por :c:func:`PySeqIter_New` y "
+"Objeto tipo para objetos iteradores retornados por :c:func:`PySeqIter_New` y "
 "la forma de un argumento de la función incorporada :func:`iter` para los "
 "tipos de secuencia incorporados."
 
@@ -66,7 +66,7 @@ msgid ""
 "Type object for iterator objects returned by :c:func:`PyCallIter_New` and "
 "the two-argument form of the :func:`iter` built-in function."
 msgstr ""
-"Objeto tipo para los objetos iteradores devueltos por :c:func:"
+"Objeto tipo para los objetos iteradores retornados por :c:func:"
 "`PyCallIter_New` y la forma de dos argumentos de la función incorporada :"
 "func:`iter`."
 
 
@@ -42,7 +42,7 @@ msgid ""
 "determine what type of keys it supports. This function always succeeds."
 msgstr ""
 "Retorna ``1`` si el objeto proporciona el protocolo de mapeo o admite "
-"rebanado (*slicing*), y ``0`` de lo contrario. Tenga en cuenta que devuelve "
+"rebanado (*slicing*), y ``0`` de lo contrario. Tenga en cuenta que retorna "
 "``1`` para las clases de Python con un método :meth:`__getitem__` ya que, en "
 "general, es imposible determinar qué tipo de claves admite. Esta función "
 "siempre tiene éxito."
 
@@ -383,7 +383,7 @@ msgid ""
 msgstr ""
 "Retorna el entero *n* convertido a base *base* como una cadena de "
 "caracteres. El argumento *base* debe ser uno de 2, 8, 10 o 16. Para la base "
-"2, 8 o 16, la cadena devuelta está prefijada con un marcador base de "
+"2, 8 o 16, la cadena retornada está prefijada con un marcador base de "
 "``'0b'``', ``'0o'`` o ``'0x'``, respectivamente. Si *n* no es un entero "
 "(*int*) Python, primero se convierte con :c:func:`PyNumber_Index`."
 
 
@@ -62,10 +62,9 @@ msgid ""
 msgstr ""
 "Retorna un puntero a una ubicación de memoria de solo lectura que se puede "
 "usar como entrada basada en caracteres. El argumento *obj* debe admitir la "
-"interfaz de búfer de caracteres de segmento único. En caso de éxito, "
-"devuelve ``0``, establece *buffer* en la ubicación de memoria y *buffer_len* "
-"en la longitud del búfer. Retorna ``-1`` y lanza :exc:`TypeError` en caso de "
-"error."
+"interfaz de búfer de caracteres de segmento único. En caso de éxito, retorna "
+"``0``, establece *buffer* en la ubicación de memoria y *buffer_len* en la "
+"longitud del búfer. Retorna ``-1`` y lanza :exc:`TypeError` en caso de error."
 
 #: ../Doc/c-api/objbuffer.rst:32
 msgid ""
@@ -87,7 +86,7 @@ msgid ""
 "Otherwise returns ``0``.  This function always succeeds."
 msgstr ""
 "Retorna ``1`` si *o* admite la interfaz de búfer legible de segmento único. "
-"De lo contrario, devuelve ``0``. Esta función siempre tiene éxito."
+"De lo contrario, retorna ``0``. Esta función siempre tiene éxito."
 
 #: ../Doc/c-api/objbuffer.rst:44
 msgid ""
 
@@ -156,7 +156,7 @@ msgid ""
 "number of keys for which ``o[key] == value``.  On failure, return ``-1``.  "
 "This is equivalent to the Python expression ``o.count(value)``."
 msgstr ""
-"Retorna el número de apariciones de *value* en *o*, es decir, devuelve el "
+"Retorna el número de apariciones de *value* en *o*, es decir, retorna el "
 "número de claves para las que ``o[clave]==value``. En caso de fallo, retorna "
 "``-1``. Esto es equivalente a la expresión de Python ``o.count(value)``."
 
 
@@ -156,7 +156,7 @@ msgid ""
 "Return the new set on success or ``NULL`` on failure.  Raise :exc:"
 "`TypeError` if *iterable* is not actually iterable."
 msgstr ""
-"Retorna un nuevo :class:`frozenset` que contiene objetos devueltos por "
+"Retorna un nuevo :class:`frozenset` que contiene objetos retornados por "
 "*iterable*. El *iterable* puede ser ``NULL`` para crear un nuevo conjunto "
 "congelado vacío. Retorna el nuevo conjunto en caso de éxito o ``NULL`` en "
 "caso de error. Lanza :exc:`TypeError` si *iterable* no es realmente iterable."
 
@@ -40,7 +40,7 @@ msgstr ""
 "incrementa. Si el objeto implementa la interfaz :class:`os.PathLike`, "
 "entonces :meth:`~os.PathLike.__fspath__` se retorna siempre que sea un "
 "objeto :class:`str` o :class:`bytes`. De lo contrario :exc:`TypeError` se "
-"lanza y se devuelve ``NULL``."
+"lanza y se retorna ``NULL``."
 
 #: ../Doc/c-api/sys.rst:22
 msgid ""
 
@@ -212,7 +212,7 @@ msgid ""
 "The same as ``PyStructSequence_InitType``, but returns ``0`` on success and "
 "``-1`` on failure."
 msgstr ""
-"Lo mismo que ``PyStructSequence_InitType``, pero devuelve ``0`` en caso de "
+"Lo mismo que ``PyStructSequence_InitType``, pero retorna ``0`` en caso de "
 "éxito y ``-1`` en caso de error."
 
 #: ../Doc/c-api/tuple.rst:148