La has leído toda la material introductorio y has decidido que quieres seguir utilizando Django. Solo hemos empezado a raspar la superficie con esta introducción (de hecho, si has leído cada una de las palabras, has leído alrededor del 5% de la documentación en general).
¿Qué sigue?
Bueno, siempre hemos sido fanáticos de aprender haciendo. En este punto deberías saber lo suficiente como para empezar un proyecto propio y empezar a jugar con él. A medida que necesites aprender nuevas trucos, vuelve a la documentación. También hay un ecosistema Django más grande fuera allí para explorarlo que la comunidad ha creado.
Hemos puesto mucho esfuerzo en hacer que la documentación de Django sea útil, clara y lo más completa posible. El resto de este documento explica más sobre cómo funciona la documentación para que puedas sacar el máximo provecho a ella.
(Sí, esto es documentación sobre documentación. Asegúrate de que no tenemos planes de escribir un documento sobre cómo leer el documento sobre documentación.)
Django tiene una gran cantidad de documentación – casi 450.000 palabras y contando –, así que encontrar lo que necesitas puede ser a veces complicado. Un buen lugar para empezar es la Índice. También recomendamos utilizar la función de búsqueda integrada.
O simplemente puedes navegar por aquí!
La documentación principal de Django se divide en «trozos» diseñados para satisfacer diferentes necesidades:
The material introductorio está diseñado para personas nuevas en Django – o en el desarrollo web en general. No cubre nada a fondo, sino que ofrece una visión general de alto nivel sobre cómo desarrollar en Django «siente».
Los guias temáticas, por otro lado, se sumergen profundamente en partes individuales de Django. Hay guías completas del sistema de modelos de Django <topics/db/index>, el motor de plantillas <topics/templates>, el marco de formularios <topics/forms/index> y mucho más.
Probablemente es aquí donde querrás pasar la mayor parte de tu tiempo; si trabajas a través de estas guías, deberías salir sabiendo prácticamente todo sobre Django.
El desarrollo web suele ser ancho, no profundo – los problemas abarcan muchos dominios. Hemos escrito un conjunto de guias paso a paso que responden preguntas comunes «¿Cómo hago…?». Aquí encontrarás información sobre la generación de PDFs con Django <howto/outputting-pdf>, la escritura de etiquetas de plantilla personalizadas <howto/custom-template-tags> y más.
Las respuestas a las preguntas muy comunes también se pueden encontrar en el FAQ.
Los guías y cómo-hacer-no cubren cada clase, función y método disponible en Django – eso sería abrumador cuando estás tratando de aprender. En su lugar, los detalles sobre clases individuales, funciones, métodos y módulos se mantienen en el referencia. Aquí es donde te dirigirás para encontrar los detalles de una función o lo que necesites.
Si estás interesado en desplegar un proyecto para uso público, nuestros documentos tienen varias guías para diferentes configuraciones de despliegue así como una lista de verificación de despliegue para algunas cosas que debes tener en cuenta.
Finalmente, hay alguna documentación «especializada» no usualmente relevante para la mayoría de los desarrolladores. Esto incluye las notas de lanzamiento y la documentación interna para aquellos que quieren agregar código a Django mismo, y un poco más de otras cosas que no encajan en ninguna parte.
Justo como el código base de Django se desarrolla e improve diariamente, nuestra documentación está mejorando constantemente. Mejoramos la documentación por varias razones:
Para hacer correcciones de contenido, como correcciones gramaticales o de ortografía.
Para agregar información y/o ejemplos a secciones existentes que necesitan ser ampliadas.
Para documentar características de Django que aún no están documentadas. (La lista de tales características está disminuyendo pero existe en cualquier caso).
Para agregar documentación para nuevas características a medida que se agregan nuevas características, o cuando cambian las APIs o comportamientos de Django.
La documentación de Django se mantiene en el mismo sistema de control de versiones que su código. Vive en el directorio docs de nuestro repositorio Git. Cada documento en línea es un archivo de texto separado en el repositorio.
Puedes leer la documentación de Django de varias maneras. Son, en orden de preferencia:
La versión más reciente de la documentación de Django vive en https://docs.djangoproject.com/en/dev/. Estas páginas HTML se generan automáticamente a partir de los archivos de texto en el control de versiones. Por lo tanto, reflejan lo «más nuevo y mejor» en Django – incluyen las correcciones y adiciones más recientes, y discuten las características de Django más recientes, que pueden estar disponibles solo para usuarios de la versión de desarrollo de Django. (Ver diferencias-entre-versiones-de-doc a continuación).
Te animamos a ayudar a mejorar los docs enviando cambios, correcciones y sugerencias en el sistema de tickets. Los desarrolladores de Django monitorean activamente el sistema de tickets y utilizan su retroalimentación para mejorar la documentación para todos.
No obstante, es importante que los tickets estén relacionados explícitamente con la documentación, en lugar de preguntar sobre cuestiones de soporte técnico generales. Si necesitas ayuda con tu configuración particular de Django, prueba el Foro de Django o el servidor de Discord de Django en su lugar.
Para leer la documentación de Django en texto plano, tanto en línea como offline, puedes hacerlo de forma conveniente.
Si estás utilizando una versión oficial de Django, el paquete comprimido (tarball) del código incluye un directorio docs/, que contiene toda la documentación para esa versión.
Si estás utilizando la versión de desarrollo de Django (también conocida como la rama principal), el directorio docs/ contiene toda la documentación. Puedes actualizar tu checkout Git para obtener los cambios más recientes.
Una forma baja-tech de aprovechar la documentación en texto es utilizando la utilidad Unix grep para buscar una frase en toda la documentación. Por ejemplo, esto mostrará cada mención de la palabra «max_length» en cualquier documento de Django:
$ grep -r max_length /path/to/django/docs/
Puedes obtener una copia local de la documentación en HTML siguiendo unos pocos pasos.
La documentación de Django utiliza un sistema llamado Sphinx para convertir el texto plano a HTML. Necesitarás instalar Sphinx descargando e instalándolo desde el sitio web de Sphinx, o con pip:
$ python -m pip install Sphinx
Luego, utiliza el archivo Makefile incluido para convertir la documentación en HTML:
$ cd path/to/django/docs
$ make html
You necesitarás GNU Make instalado para esto.
Si estás en Windows puedes utilizar alternativamente el archivo de batch incluido:
cd path\to\django\docs
make.bat html
La documentación HTML se colocará en docs/_build/html.
La documentación de texto en la rama principal del repositorio Git contiene los «últimos y mejores» cambios y agregados. Estos cambios incluyen la documentación de nuevas características destinadas a la próxima liberación de características de Django. Por esa razón, es importante destacar nuestra política para resaltar los cambios y agregados recientes en Django.
Seguimos esta política:
La documentación de desarrollo en https://docs.djangoproject.com/en/dev/ proviene de la rama principal. Estos docs corresponden a la última liberación de características, más lo que se ha agregado o cambiado en el marco desde entonces.
A medida que agregamos características a la versión de desarrollo de Django, actualizamos la documentación en el mismo commit de Git.
Para distinguir los cambios/agregados de características en los docs, utilizamos la frase: «Nuevos en la versión de desarrollo de Django» para la versión de Django que aún no se ha liberado, o «Nuevos en la versión X.Y» para versiones liberadas.
Los arreglos y mejoras de documentación pueden ser retroportados a la rama de liberación más reciente, según la discreción del merge, sin embargo, una vez que una versión de Django ya no es soportada, esa versión de los docs no recibirá actualizaciones adicionales.
La página principal de la documentación web incluye enlaces a la documentación de versiones anteriores. Asegúrate de que estás utilizando la versión de la documentación correspondiente a la versión de Django que estás utilizando!
may 31, 2026