cap12: revisão de estilo

Author: ramalho

code/12-seq-hacking/soma-pythonica.ipynb

@@ -57,7 +57,7 @@
    "id": "55d9e82e-8d55-4e83-bd63-6053aaac8382",
    "metadata": {},
    "source": [
-    "Este código usa um excesso de elementos idiomáticos de Python: `lambda`, `reduce` e uma compreensão de lista.\n",
+    "Este código usa várias peculiaridades de Python: `lambda`, `reduce` e uma compreensão de lista.\n",
     "\n",
     "## Sobre o reduce\n",
     "\n",
@@ -174,9 +174,9 @@
    "metadata": {},
    "source": [
     "Se você vai usar `lambda`, provavelmente não há razão para usar uma compreensão\n",
-    "de lista—exceto para filtragem, que não é o caso aqui.\n",
+    "de lista—exceto para filtrar com `if`, que não é o caso aqui.\n",
     "\n",
-    "Aqui está uma solução minha que ofenderá todo mundo, exceto os amantes de `lambda`:"
+    "Aqui está uma solução minha que ofenderá todo mundo, exceto os fanáticos por `lambda`:"
    ]
   },
   {
@@ -207,12 +207,13 @@
     "jp-MarkdownHeadingCollapsed": true
    },
    "source": [
-    "Não participei da discussão original, e não usaria o trecho acima em código real,\n",
-    "pois eu também não gosto muito de `lambda`.\n",
+    "Não participei da discussão original,\n",
+    "e não usaria este código porque também não gosto muito de `lambda`,\n",
+    "principalmente em casos obscuros como este.\n",
     "\n",
-    "Apenas quis mostrar um exemplo sem uma compreensão de lista.\n",
+    "Apenas quis mostrar aqui um exemplo sem uma compreensão de lista.\n",
     "\n",
-    "A primeira resposta veio de Fernando Perez, criador do IPython,\n",
+    "A primeira resposta veio de Fernando Perez, criador do IPython e do Jupyter,\n",
     "mostrando como a NumPy suporta arrays _n_-dimensionais e fatiamento _n_-dimensional:"
    ]
   },
@@ -248,7 +249,7 @@
     "jp-MarkdownHeadingCollapsed": true
    },
    "source": [
-    "Acho a solução de Perez boa, mas Guy Middleton elegiou essa próxima solução,\n",
+    "Acho a solução de Perez boa, mas Guy Middleton elogiou essa próxima solução,\n",
     "de Paul Rubin e Skip Montanaro:"
    ]
   },

online/cap12.adoc

@@ -1275,25 +1275,25 @@ o uso do `*` como opção de formatação.
 [role="soapbox-title"]
 **A busca por uma soma pythônica**
 
-Não há((("Soapbox sidebars", "Pythonic sums", id="SSpysum12")))((("Pythonic
-sums", id="pysum12"))) uma resposta única para a "O que é pythônico?", da mesma
-forma que não há uma resposta única para "O que é belo?". Dizer, como eu mesmo
-muitas vezes faço, que significa usar "Python idiomático" não é 100%
-satisfatório, porque talvez o que é "idiomático" para você não seja para mim.
-Uma coisa eu sei: "idiomático" não significa abusar dos recursos mais obscuros
-da linguagem.
-
-Na https://fpy.li/12-11[Python-list], há uma thread de abril de 2003 chamada
+Na((("Soapbox sidebars", "Pythonic sums",
+id="SSpysum12")))((("Pythonic sums", id="pysum12")))
+https://fpy.li/12-11[Python-list], há uma thread de abril de 2003 chamada
 https://fpy.li/12-12[_Pythonic Way to Sum n-th List Element?_] (A forma
 pythônica de somar o n-ésimo elemento em listas)].
-Ela é relevante para nossa discussão de `reduce` neste capítulo.
+
+Não há uma resposta única para a "O que é pythônico?", da mesma
+forma que não há uma resposta única para "O que é belo?"
+
+Mas talvez esta troca de ideias traga alguma luz.
 
 O autor original, Guy Middleton, pediu melhorias para a solução abaixo, afirmando
 não gostar de usar `lambda`. Adaptei o código apresentado aqui: em
 2003, `reduce` era uma função embutida, mas no Python 3 precisamos importá-la;
 também substitui os nomes `x` e `y` por `my_list` e `sub` (para sub-lista),
 e usei `ac` como variável acumuladora na para o `reduce`.
 
+No caso específico, Middleton quer somar o segundo item de cada lista de uma série de listas.
+
 [source, python]
 ----
 >>> from functools import reduce
@@ -1302,28 +1302,31 @@ e usei `ac` como variável acumuladora na para o `reduce`.
 60
 ----
 
-Esse código usa muitos idiomas: `lambda`, `reduce` e uma compreensão de lista.
+Esse código usa várias peculiaridades de Python:
+`lambda`, `reduce` e uma compreensão de lista.
 Ele provavelmente ficaria em último lugar em um concurso de popularidade, pois
 ofende quem odeia `lambda` e também aqueles que desprezam as compreensões de
-lista—praticamente os dois lados de uma disputa.
+lista.
 
 Se você vai usar `lambda`, provavelmente não há razão para usar uma compreensão
-de lista—exceto para filtragem, que não é o caso aqui.
+de lista—exceto para filtrar com `if`, que não é o caso aqui.
 
-Aqui está uma solução minha que agradará os amantes de `lambda`:
+Aqui está uma solução minha que ofenderá todo mundo, exceto os fanáticos por `lambda`:
 
 [source, python]
 ----
 >>> reduce(lambda ac, sub: ac + sub[1], my_list, 0)
 60
 ----
 
-Não tomei parte na discussão original, e não usaria o trecho acima em código real,
-pois eu também não gosto muito de `lambda`.
-Apenas quis mostrar um exemplo sem uma compreensão de lista.
+Não participei da discussão original,
+e não usaria este código porque também não gosto muito de `lambda`,
+principalmente em casos obscuros como este.
+Apenas quis mostrar aqui um exemplo sem uma compreensão de lista.
 
-A primeira resposta veio de Fernando Perez, criador do IPython, e realça como a
-NumPy suporta arrays _n_-dimensionais e fatiamento _n_-dimensional:
+A primeira resposta veio de Fernando Perez, criador do IPython e do Jupyter
+Notebook, mostrando como a NumPy suporta arrays _n_-dimensionais e fatiamento
+_n_-dimensional:
 
 [source, python]
 ----
@@ -1333,7 +1336,7 @@ NumPy suporta arrays _n_-dimensionais e fatiamento _n_-dimensional:
 60
 ----
 
-Acho a solução de Perez boa, mas Guy Middleton elegiou essa próxima solução,
+Acho a solução de Perez boa, mas Guy Middleton elogiou essa próxima solução,
 de Paul Rubin e Skip Montanaro:
 
 [source, python]