From 22ebe3b9be59bbf50f804c966be9e8796ec83310 Mon Sep 17 00:00:00 2001 From: Manuel Kaufmann Date: Thu, 8 Oct 2020 16:29:08 +0200 Subject: [PATCH 1/3] Clarify why two or one spaces and code formatting --- .overrides/faq.rst | 37 +++++++++++++++++++++++++++++++------ 1 file changed, 31 insertions(+), 6 deletions(-) diff --git a/.overrides/faq.rst b/.overrides/faq.rst index 545a059701..81c8c6048e 100644 --- a/.overrides/faq.rst +++ b/.overrides/faq.rst @@ -193,12 +193,12 @@ 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 +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 @@ -207,11 +207,36 @@ 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 + git push origin 3.8 ¡Eso es todo! +¿Son importantes los dobles espacios en el original? +---------------------------------------------------- + +No. + +En realidad, no tienen ningún efecto. Sphinx se da cuenta automáticamente de esto y simplemente +deja un solo espacio en la versión final. Así que, no te preocupes si ves dos espacios juntos. + +Si estás interesada en saber más sobré "¿Porqué se usan dobles espacios?" puedes leer este artículo: +`How Many Spaces Should Be After a Period? `_ + + +¿Puedo agregar "estilo de código" a los nombres de las funciones/métodos/clases/etc? +------------------------------------------------------------------------------------ + +No. + +Si aparece el nombre de una función (por ejemplo, "IncrementalParser") en el original y no tiene ningún estilo asociado +(no está en cursiva, ni en negrita ni en estilo de código), aunque sientas la tentación de ponerla como +``IncrementalParser``, no debes hacerlo. + +En principio, no debemos cambiar el formato de estas palabras. Si realmente crees que es un error y debería +estar con un formato distinto, debes reportarlo en el repositorio de CPython. + + ¿Tienen una lista de correo? ---------------------------- From 5ff2ded9ba638e084d8a8637fc45a970c275bb18 Mon Sep 17 00:00:00 2001 From: Manuel Kaufmann Date: Thu, 8 Oct 2020 16:34:08 +0200 Subject: [PATCH 2/3] Backticks and * --- .overrides/faq.rst | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/.overrides/faq.rst b/.overrides/faq.rst index 81c8c6048e..0679afd21c 100644 --- a/.overrides/faq.rst +++ b/.overrides/faq.rst @@ -233,7 +233,8 @@ Si aparece el nombre de una función (por ejemplo, "IncrementalParser") en el or (no está en cursiva, ni en negrita ni en estilo de código), aunque sientas la tentación de ponerla como ``IncrementalParser``, no debes hacerlo. -En principio, no debemos cambiar el formato de estas palabras. Si realmente crees que es un error y debería +En principio, no debemos cambiar el formato de estas palabras. Si está con asteriscos, lo dejamos con asteriscos. +Si está con backticks, lo dejamos con los backticks, etc. Si realmente crees que es un error y debería estar con un formato distinto, debes reportarlo en el repositorio de CPython. From 646c51f73d59b501b03111f49071faefeb62c960 Mon Sep 17 00:00:00 2001 From: Manuel Kaufmann Date: Thu, 8 Oct 2020 18:36:56 +0200 Subject: [PATCH 3/3] Update .overrides/faq.rst MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Cristián Maureira-Fredes --- .overrides/faq.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.overrides/faq.rst b/.overrides/faq.rst index 0679afd21c..a816dbb1ed 100644 --- a/.overrides/faq.rst +++ b/.overrides/faq.rst @@ -220,7 +220,7 @@ No. En realidad, no tienen ningún efecto. Sphinx se da cuenta automáticamente de esto y simplemente deja un solo espacio en la versión final. Así que, no te preocupes si ves dos espacios juntos. -Si estás interesada en saber más sobré "¿Porqué se usan dobles espacios?" puedes leer este artículo: +Si estás interesada en saber más sobré "¿Por qué se usan dobles espacios?" puedes leer este artículo: `How Many Spaces Should Be After a Period? `_