La documentación de Python ya está disponible en alemán

La documentación oficial de Python ya tiene una edición en alemán. El proyecto Python lo anunció el 26 de septiembre de 2026, y las páginas están en docs.python.org/de/3/. Es importante porque los hablantes de alemán ahora pueden aprender el lenguaje con su propia referencia, no con libros o artículos de blog de terceros.

El anuncio lo hizo Stan Ulbrych en el blog Python Insider. "¡Nos alegra anunciar que la documentación de Python ya está disponible en alemán (Deutsch)!", escribió. Reconoció a los voluntarios de la comunidad que hicieron el trabajo de traducción.

Qué está traducido hasta ahora

La edición en alemán está completa donde más importa primero, y escasa en todo lo demás. El panel de traducción del proyecto en translations.python.org sigue dos cifras para cada idioma.

Medida	Progreso del alemán
Documentación principal	100 %
Progreso principal en los últimos 30 días	23,79 %
Documentación completa	9,17 %
Progreso completo en los últimos 30 días	5,87 %

Así que aproximadamente una cuarta parte del conjunto principal se terminó en el último mes antes del lanzamiento. La documentación completa es un volumen de texto mucho mayor. Incluye la referencia de la biblioteca estándar, que describe en detalle cada módulo integrado.

El sitio en alemán ofrece varias versiones de Python. Su menú de versiones muestra Python 3.14.7 como la versión estable actual. También ofrece 3.15, que está en prelanzamiento, y 3.16, que sigue en desarrollo.

Por qué un idioma solo aparece cuando su núcleo está terminado

Las reglas de Python para las traducciones vienen de la PEP 545, una Python Enhancement Proposal. Una PEP es el documento de diseño formal que el proyecto usa para decidir cómo funcionan las cosas.

La PEP 545 fija un requisito antes de que un idioma aparezca en el menú de idiomas de la documentación. Tres partes deben estar traducidas al 100 %: la página sobre cómo informar de errores, el tutorial y la referencia de las funciones integradas. Por eso un idioma nuevo puede publicarse mientras la mayoría de sus páginas siguen en inglés. Las partes que un principiante lee primero están terminadas. El resto llega después.

La misma PEP fija el patrón de la dirección web, docs.python.org/LANGUAGE/VERSION/. También exige un coordinador designado por idioma. Para el alemán, la Python Developer's Guide nombra a Swen Bachmann como ese coordinador. Los archivos de traducción están en su repositorio de GitHub, python-docs-de, que muestra 361 commits.

Cómo funciona el proceso de traducción

Los traductores nunca editan directamente las páginas de la documentación. Según la Developer's Guide, trabajan en archivos PO de gettext. Gettext es un conjunto de herramientas habitual para traducir software. Un archivo PO lista cada frase en inglés junto a un espacio para su traducción.

Sphinx, la herramienta que genera la documentación de Python, crea esos archivos a partir del texto fuente en inglés. Cuando los traductores terminan, unos scripts de compilación recogen los archivos y los publican automáticamente en docs.python.org. El equipo alemán gestiona su trabajo a través de Transifex, una plataforma web para proyectos de traducción.

Los colaboradores deben aceptar primero un acuerdo de contribución a la documentación. Según la PEP 545, este ofrece su trabajo bajo la licencia CC0, una dedicación al dominio público. El alemán se suma a 27 proyectos de traducción activos, entre ellos francés, español, japonés, ruso, húngaro y las dos formas del chino.

Qué significa para los desarrolladores

Si enseñas Python a hablantes de alemán, dirígelos ya a docs.python.org/de/3/ para el tutorial y la referencia de las funciones integradas. Esas partes están totalmente traducidas. En la referencia de la biblioteca estándar, espera que la mayoría de las páginas sigan en inglés, ya que el conjunto completo está al 9,17 %.

Revisa la versión de cada enlace que compartas. El sitio en alemán ofrece varias versiones, desde la 2.6 hasta la documentación de desarrollo de la 3.16. Un enlace a /de/3/ sigue la versión estable actual, mientras que un enlace con número de versión se mantiene fijo. Usa la forma fija en el material de curso que no pienses actualizar.

Si escribes en alemán y conoces Python, esta es una de las formas más fáciles de contribuir al proyecto. Traduces entradas PO a través de Transifex, y la Developer's Guide explica la configuración. La cifra del 9,17 % muestra cuánto de la referencia de la biblioteca aún necesita manos.

Mantén la coherencia de los términos. La Developer's Guide pide a los traductores que respeten los nombres técnicos, así que nombres como dict o asyncio se quedan como están. Solo cambia el texto que los rodea.

Por último, vigila el panel si tu equipo trabaja en otro idioma. La misma regla del 100 % del núcleo decide cuándo aparece esa edición en el menú de idiomas.