Merge branch '3.8' into trad-lexical-analysis

Author: MiguelHeCa

.gitignore

@@ -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__/

.overrides/CONTRIBUTING.rst

@@ -38,6 +38,7 @@ contribución, queremos señalar algunos lineamientos generales.
 
 - 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.
+  (mira la `Guía del revisor`_)
 
 - Último pero no menos importante, divertite y contá con la ayuda de todes. Te
   esperamos en nuestro chat en telegram. ¡Gracias!
@@ -146,7 +147,7 @@ A tener en cuenta
 * 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.
-  
+
 * Te recomendamos abrir una Pull Request aunque sea en formato borrador (marcada
   como draft) desde los primeros commits de la traducción de tu fichero. De esta
   forma, puedes recibir feedback desde el principio que puedes aplicar al resto
@@ -182,6 +183,8 @@ Tendrás que navegar hasta el archivo que hayas cambiado para ver cómo se visua
 .. _nuestro canal de Telegram: https://t.me/python_docs_es
 .. _Memoria de traducción:
    https://python-docs-es.readthedocs.io/page/translation-memory.html
+.. _Guía del revisor:
+   https://python-docs-es.readthedocs.io/page/reviewers-guide.html
 .. _la traducción al Portugués: https://docs.python.org/pt-br/3/
 .. _lista de issues en GitHub:
    https://github.com/python/python-docs-es/issues?q=is%3Aissue+is%3Aopen+sort%3Aupdated-desc+no%3Aassignee+translate

.overrides/faq.rst

@@ -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?
 --------------------------------------------------------------------------------------
 

.overrides/reviewers-guide.rst

@@ -0,0 +1,34 @@
+================================
+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

.overrides/translation-memory.rst

@@ -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
 

.travis.yml

@@ -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:

Makefile

@@ -89,7 +89,10 @@ progress: venv
 
 .PHONY: spell
 spell: venv
-	$(VENV)/bin/pospell -p dict -l es_ES **/*.po
+        # 'cat' tenia el problema que algunos archivos no tenían una nueva línea al final
+        # 'awk 1' agregará una nueva línea en caso que falte.
+	awk 1 dict dictionaries/*.txt > dict.txt
+	$(VENV)/bin/pospell -p dict.txt -l es_ES **/*.po
 
 
 .PHONY: wrap

TRANSLATORS

@@ -1,32 +1,47 @@
+Juan Alegría (@zejiran)
+Nahuel Ambrosini (@ambro17)
+Gabriel Anguita (@gabrielanguita)
 Paula Aragón (@pandrearro)
 Emmanuel Arias (@eamanu)
 Paula Aragón (@pandrearro
 Jhonatan Barrera (@iam3mer)
+Reinny Almonte Ramos (@jighdan)
+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)
+Nahuel Espinosa (@nahueespinosa)
 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)
 María José Molina Contreras (@mjmolina)
 Marco Richetta (@marcorichetta)
+Adolfo Hristo David Roque Gámez (@hristoroque)
 Elisabeth Ortega (@draentropia)
 Cristian Rengifo (@ingrengifo)
 Pablo Lobariñas (@Qkolnek)
 Sergio Delgado Quintero (@sdelquin)
 Silvina Tamburini (@silvinabt87)
 David Trigo Chávez (@dtrinf)
 Agustina Quiros (@qagustina)
+Marcos Sánchez Provencio (@rapto)
+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)