Traduzir exemplos de código?

[GoogleCodeExporter]

Tomando por base o capítulo em "controlflow.html", alguns trechos de código 
estão no original em inglês.  Por exemplo:

def parrot(voltage, state='a stiff', action='voom', type='Norwegian Blue'):
    print "-- This parrot wouldn't", action,
    print "if you put", voltage, "volts through it."
    print "-- Lovely plumage, the", type
    print "-- It's", state, "!"

Apesar de a maioria dos programadores ter boa compreensão do idioma inglês, 
principalmente ao tentar lidar o desafio de aprender algo novo, se deparar com 
um trecho relevante em inglês pode afugentar os mais inseguros.

O trecho seguinte no mesmo arquivo também utiliza uma função chamada 
"cheeseshop", cujo contexto não é natural para muitos.  Por mais que 
entendamos a tradução, uma "cheeseshop" definitivamente não significa o 
mesmo para um brasileiro que para um norte-americano.  A não-identificação 
com o contexto deixa de apreender o leitor.

Assim, este tíquete tem menos a ver com a tradução em si, e mais a ver 
talvez com o caráter pedagógico do texto.

Sugeriria que, (se possível, dadas considerações sobre direito autoral e 
manutenção do sentido do texto o mais fiel possível com o original) trechos 
de código fossem convertidos para um contexto mais comum ao brasileiro.  Por 
exemplo, o método "parrot" poderia virar um método "arara" (na verdade, este 
não foi um bom exemplo, mas espero que tenham compreendido).

Original issue reported on code.google.com by mfandrade on 25 Feb 2012 at 3:03

[GoogleCodeExporter]

Marcelo,

de acordo. Inclusive, regra geral, estamos traduzindo trechos de códigos sim.
E dando preferencia ao bom entendido do leitor sobre a tradução literal do 
texto.

Como esse é um dos primeiros capítulos, quando o Luciano estava sozinho, 
talvez essa noção não estivesse bem clara, ou pode ter passado batido mesmo.

A proposito, hoje mesmo eu li, acho que em algum capítulo desse tutorial, um 
nota de rodapé sobre o cheeseshop, e nesse caso, eu acho até mais 
interessante do que tentarmos uma tradução.

Original comment by adorilson on 25 Feb 2012 at 8:16

[GoogleCodeExporter]

A maioria dos trechos de código que eu encontrei eu traduzi: strings e 
identificadores inclusive. Porém em alguns casos o código fazia alguma piada 
intraduzível, e nesses casos preferi manter o texto no original, colocando uma 
N.d.T.

Original comment by luci...@ramalho.org on 8 Apr 2012 at 9:58