Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Traducido reference/expressions #2283

Open
wants to merge 19 commits into
base: 3.12
Choose a base branch
from
Open

Traducido reference/expressions #2283

wants to merge 19 commits into from

Conversation

cmaureir
Copy link
Collaborator

Closes #1902

reference/expressions.po Outdated Show resolved Hide resolved
reference/expressions.po Outdated Show resolved Hide resolved
reference/expressions.po Outdated Show resolved Hide resolved
reference/expressions.po Outdated Show resolved Hide resolved
reference/expressions.po Outdated Show resolved Hide resolved
reference/expressions.po Outdated Show resolved Hide resolved
reference/expressions.po Outdated Show resolved Hide resolved
reference/expressions.po Outdated Show resolved Hide resolved
reference/expressions.po Show resolved Hide resolved
reference/expressions.po Outdated Show resolved Hide resolved
@cmaureir cmaureir requested a review from sofide February 27, 2023 22:17
reference/expressions.po Outdated Show resolved Hide resolved
reference/expressions.po Outdated Show resolved Hide resolved
reference/expressions.po Outdated Show resolved Hide resolved
reference/expressions.po Outdated Show resolved Hide resolved
reference/expressions.po Outdated Show resolved Hide resolved
dictionaries/reference_expressions.txt Outdated Show resolved Hide resolved
@cmaureir
Copy link
Collaborator Author

cmaureir commented Mar 1, 2023

Creo que el problema lo tenemos porque no está definido cómo manejar el término yield. Si bien hace sentido usar produce, me da un poco de miedo que no tenemos un mecanismo para verificar cuando es yield la palabra de python, o yield el verbo.

Si estamos en referencia a generadores, creo que valdría la pena hacer referencia a yield, y podríamos quizás acordar que para casos como

The awaitable returned by the :meth:asend method will return the next value yielded by the generator as the value of the raised :exc:StopIteration.

traducirlos a :

El esperable retornado por el método :meth:asend devolverá el siguiente valor producido (yield) por el generador como el valor de :exc:StopIteration generado.

¿Suena como mejor plan?
tendríamos que revisar muy bien los textos, pero no me gustaría usar solo "producido" ya que en las cabezas de quienes lean no estará siempre la relación "producido -> 'ah, debe ser con yield'".

Si alguien tiene otra mejor propuesta, sería genial 👯

(Que por cierto abre otro tarro con gusanos "awaitable -> esperable (?)")

@rtobar
Copy link
Collaborator

rtobar commented Mar 2, 2023

¿Suena como mejor plan? tendríamos que revisar muy bien los textos, pero no me gustaría usar solo "producido" ya que en las cabezas de quienes lean no estará siempre la relación "producido -> 'ah, debe ser con yield'".

Que tal usar "ceder"/"cedido" para estos casos? Creo que se ajusta bien a la semántica de yield que no sólo produce un valor, sino que además cede el control de la ejecución.

@sofide
Copy link
Contributor

sofide commented Mar 3, 2023

@cmaureir me gusta lo que propones de:

producido (yield)

Y creo que estamos de acuerdo que eso sería solo en las secciones que hablan de generadores, en el resto de las secciones debería quedar solo el verbo "producir", sino va a generar mucha confusión jeje.

Sobre esto que decis:

no tenemos un mecanismo para verificar cuando es yield la palabra de python, o yield el verbo.

En realidad viendo rápido el texto pareciera que siempre que se habla de "yield la palabra de python" en la docu dice explícitamente "yield expression". Entonces yo traduciría siempre "yield expression" -> "expresión yield ", y en el resto de los yields como verbo "producir" (aclarando entre parentesis (yield), tal como lo propones, solo cuando hablamos de generadores.

@sofide
Copy link
Contributor

sofide commented Mar 3, 2023

@rtobar es cierto que "yield" tmb se puede traducir como "ceder"... Lo que me preocupa es que en la docu tmb usan el verbo "yield" para explicar otras cosas que no son generadores y en estos casos el verbo "ceder" no calza tan bien. Por ejemplo cuando se explica la sintaxis de las listas:

"A list display yields a new list object, the contents being specified by "
"either a list of expressions or a comprehension. (...) "

De todas formas si somos cuidadosos en donde traducimos como "producir" y en donde como "ceder". puede ser que funcione 👍

@mmmarcos
Copy link
Collaborator

mmmarcos commented Mar 3, 2023

@sofide @cmaureir me parece re bien la propuesta:

Entonces yo traduciría siempre "yield expression" -> "expresión yield ", y en el resto de los yields como verbo "producir" (aclarando entre parentesis (yield), tal como lo propones, solo cuando hablamos de generadores.

Es super claro y queda mas explícito el significado del texto original 👍

@eamanu
Copy link
Contributor

eamanu commented May 20, 2023

Me parece mejor

producido (yield)

Pero creo que siempre se debería usar el (yield), me parece que es más sencillo mantener esa referencia a yield para seguir estando cerca de lo que se usa en el lenguaje.

@cmaureir cmaureir changed the base branch from 3.11 to 3.12 October 14, 2023 12:31
@github-actions
Copy link

Este PR lleva un tiempo sin actualizaciones. Vamos a pedir a un admin de nuestro equipo que decida si alguien más puede finalizarlo o si tenemos que cerrarlo.
Por favor, avisanos en caso de que aún puedas terminarlo.

Copy link

github-actions bot commented Jan 5, 2024

All entries translated, horray! 🎉

reference/expressions.po Outdated Show resolved Hide resolved
reference/expressions.po Outdated Show resolved Hide resolved
reference/expressions.po Outdated Show resolved Hide resolved
reference/expressions.po Outdated Show resolved Hide resolved
reference/expressions.po Outdated Show resolved Hide resolved
@cmaureir
Copy link
Collaborator Author

Llevamos más de un año con este PR abierto xD a ver si podemos mergear pronto

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Translate 'reference/expressions.po'
5 participants