termina la sección soapbox

Hristo Roque · Hristo Roque · commit c1eb03b66afd · 2021-03-23T00:07:40.000-05:00
diff --git a/library/doctest.po b/library/doctest.po
@@ -11,7 +11,7 @@ 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: 2021-03-22 20:11-0500\n"
+"PO-Revision-Date: 2021-03-23 00:07-0500\n"
 "Language-Team: python-doc-es\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
@@ -2897,6 +2897,7 @@ msgstr ""
 "de :mod:`doctest` paran de funcionar después de un cambio \"inofensivo\"."
 
 #: ../Doc/library/doctest.rst:1808
+#, fuzzy
 msgid ""
 "Doctest also makes an excellent tool for regression testing, especially if "
 "you don't skimp on explanatory text.  By interleaving prose and examples, it "
@@ -2916,42 +2917,80 @@ msgid ""
 "functionality seemingly at random.  It's a different attitude, and produces "
 "different results, blurring the distinction between testing and explaining."
 msgstr ""
+"Doctest también hace una excelente herramienta para pruebas de regresión, "
+"especialmente si no escatimas en texto explicativo. Al intercalar prosa y "
+"ejemplos, se hace mucho más fácil mantener seguimiento de lo que realmente "
+"se está invirtiendo, y por qué. Cuando una prueba falla, buena prosa puede "
+"hacer mucho más fácil comprender cuál es el problema, y cómo debe ser "
+"arreglado. Es verdad que puedes escribir comentarios extensos en pruebas "
+"basadas en código, pero pocos programadores lo hacen. Quizás es porque "
+"simplemente doctest hace escribir pruebas mucho más fácil que escribir "
+"código, mientras que escribir comentarios en código es mucho más dificil. "
+"Pienso que va más allá de eso: la actitud natural cuando se escribe una "
+"prueba basada en doctest es que quieres explicar los puntos finos de tu "
+"software, e ilustrarlos con ejemplos. Esto naturalmente lleva a archivos de "
+"pruebas que empiezan con las características más simples, y lógicamente "
+"progresan a complicaciones y casos extremos. Una narrativa coherente es el "
+"resultado, en vez de una colección de funciones aisladas que pruebas trozos "
+"aislados de funcionalidad aparentemente al azar. Es una actitud diferente, y "
+"produce resultados diferentes, difuminando la distinción entre probar y "
+"explicar."
 
 #: ../Doc/library/doctest.rst:1826
 msgid ""
 "Regression testing is best confined to dedicated objects or files.  There "
 "are several options for organizing tests:"
 msgstr ""
+"Pruebas de regresión se limitan mejor a objetos o archivos dedicados. Hay "
+"varias opciones para organizar pruebas:"
 
 #: ../Doc/library/doctest.rst:1829
+#, fuzzy
 msgid ""
 "Write text files containing test cases as interactive examples, and test the "
 "files using :func:`testfile` or :func:`DocFileSuite`.  This is recommended, "
 "although is easiest to do for new projects, designed from the start to use "
 "doctest."
 msgstr ""
+"Escribe archivos de texto que contienen los casos de prueba como ejemplos "
+"interactivos, y prueba los archivos usando :func:`testfile` o :func:"
+"`DocFileSuite`. Esto es lo recomendado, aunque es más fácil hacerlos para "
+"nuevos proyectos, diseñados desde el comienzo para usar doctest."
 
 #: ../Doc/library/doctest.rst:1834
+#, fuzzy
 msgid ""
 "Define functions named ``_regrtest_topic`` that consist of single "
 "docstrings, containing test cases for the named topics.  These functions can "
 "be included in the same file as the module, or separated out into a separate "
 "test file."
 msgstr ""
+"Define funciones nombradas ``_regrtest_topic`` que consisten en docstrings, "
+"que contienen casos de prueba por los tópicos nombrados. Estas funciones se "
+"pueden incluir en el mismo archivo como el módulo, o separadas en un archivo "
+"de prueba separado."
 
 #: ../Doc/library/doctest.rst:1838
+#, fuzzy
 msgid ""
 "Define a ``__test__`` dictionary mapping from regression test topics to "
 "docstrings containing test cases."
 msgstr ""
+"Define un diccionario ``__test__`` que asigna de pruebas de tópicos de "
+"pruebas de regresión a los docstring que contienen casos de prueba."
 
 #: ../Doc/library/doctest.rst:1841
+#, fuzzy
 msgid ""
 "When you have placed your tests in a module, the module can itself be the "
 "test runner.  When a test fails, you can arrange for your test runner to re-"
 "run only the failing doctest while you debug the problem.  Here is a minimal "
 "example of such a test runner::"
 msgstr ""
+"Cuando has puesto tus pruebas en un módulo, el módulo puede ser el mismo "
+"*test runner*. Cuando una prueba falla, puedes organizar para que tu *test "
+"runner* vuelva a ejecutar sólo los docttest fallidos mientras que tu depuras "
+"el problema. Aquí está el ejemplo mínimo de tal *test runner*::"
 
 #: ../Doc/library/doctest.rst:1863
 msgid "Footnotes"
