A documentação do Python agora está disponível em alemão

A documentação oficial do Python agora tem uma edição em alemão. O projeto Python anunciou isso em 26 de setembro de 2026, e as páginas estão em docs.python.org/de/3/. Isso importa porque falantes de alemão agora podem aprender a linguagem com a própria referência dela, e não com livros ou posts de blog de terceiros.

O anúncio veio de Stan Ulbrych no blog Python Insider. "Temos o prazer de anunciar que a documentação do Python agora está disponível em alemão (Deutsch)!", escreveu ele. Ele deu crédito aos voluntários da comunidade que fizeram o trabalho de tradução.

O que já está traduzido

A edição em alemão está completa onde importa primeiro, e escassa em todo o resto. O painel de tradução do projeto em translations.python.org acompanha dois números para cada idioma.

Medida	Progresso do alemão
Documentação principal	100%
Progresso principal nos últimos 30 dias	23,79%
Documentação completa	9,17%
Progresso completo nos últimos 30 dias	5,87%

Ou seja, cerca de um quarto do conjunto principal foi concluído no último mês antes do lançamento. A documentação completa é um volume de texto muito maior. Ela inclui a referência da biblioteca padrão, que descreve em detalhe cada módulo embutido.

O site em alemão oferece várias versões do Python. Seu menu de versões lista o Python 3.14.7 como a versão estável atual. Ele também oferece a 3.15, que está em pré-lançamento, e a 3.16, que ainda está em desenvolvimento.

Por que um idioma só aparece quando seu núcleo está pronto

As regras do Python para traduções vêm da PEP 545, uma Python Enhancement Proposal. Uma PEP é o documento formal de design que o projeto usa para decidir como as coisas funcionam.

A PEP 545 define um requisito antes que um idioma apareça no menu de idiomas da documentação. Três partes precisam estar 100% traduzidas: a página sobre como relatar bugs, o tutorial e a referência das funções embutidas. É por isso que um novo idioma pode entrar no ar enquanto a maioria de suas páginas ainda está em inglês. As partes que um iniciante lê primeiro estão prontas. O restante vem depois.

A mesma PEP fixa o padrão do endereço web, docs.python.org/LANGUAGE/VERSION/. Ela também exige um coordenador nomeado por idioma. Para o alemão, o Python Developer's Guide aponta Swen Bachmann como esse coordenador. Os arquivos de tradução ficam no repositório dele no GitHub, python-docs-de, que mostra 361 commits.

Como funciona o fluxo de tradução

Os tradutores nunca editam as páginas da documentação diretamente. Segundo o Developer's Guide, eles trabalham em arquivos PO do gettext. O gettext é um conjunto de ferramentas comum para traduzir software. Um arquivo PO lista cada frase em inglês ao lado de um espaço para sua tradução.

O Sphinx, a ferramenta que gera a documentação do Python, cria esses arquivos a partir do texto-fonte em inglês. Quando os tradutores terminam, scripts de build puxam os arquivos e os publicam automaticamente em docs.python.org. A equipe alemã gerencia seu trabalho pelo Transifex, uma plataforma web para projetos de tradução.

Os colaboradores precisam primeiro aceitar um acordo de contribuição para a documentação. Pela PEP 545, isso oferece o trabalho deles sob a licença CC0, uma dedicação ao domínio público. O alemão se junta a 27 projetos de tradução ativos, que incluem francês, espanhol, japonês, russo, húngaro e as duas formas do chinês.

O que isso significa para desenvolvedores

Se você ensina Python para falantes de alemão, indique agora docs.python.org/de/3/ para o tutorial e a referência das funções embutidas. Essas partes estão totalmente traduzidas. Na referência da biblioteca padrão, espere que a maioria das páginas ainda esteja em inglês, já que o conjunto completo está em 9,17%.

Confira a versão em qualquer link que você compartilhar. O site em alemão oferece várias versões, da 2.6 até a documentação de desenvolvimento da 3.16. Um link para /de/3/ acompanha a versão estável atual, enquanto um link com número de versão fica fixo. Use a forma fixa em material de curso que você não pretende atualizar.

Se você escreve em alemão e conhece Python, esta é uma das formas mais fáceis de contribuir com o projeto. Você traduz entradas PO pelo Transifex, e o Developer's Guide explica a configuração. O número de 9,17% mostra quanto da referência da biblioteca ainda precisa de mãos.

Mantenha seus termos consistentes. O Developer's Guide pede que os tradutores respeitem a nomenclatura técnica, então nomes como dict ou asyncio ficam como estão. Só muda o texto ao redor deles.

Por fim, acompanhe o painel se sua equipe trabalha em outro idioma. A mesma regra de 100% do núcleo decide quando essa edição aparece no menu de idiomas.