Ce jour, dans le RER, en attendant mon train, j'étais en train de continuer ma découverte du framewok Django. Je me disais "quel dommage de pas avoir de connexion internet, je n'ai aucune doc et c'est donc dur de pouvoir avancer sur la découverte de django..." A ce moment là un lien "Documentation" dans l'admin attire mon oeil. Je clique dessus et là : rien car il me manque le paquet docutils comme la page l'indique si bien.

En revenant chez moi, je m'empresse donc de faire :

geshi bash
sudo apt-get install python-docutils

Je relance webrick et me rend sur la page http://localhost:8000/admin/doc/ et là : que du bonheur !

Vous accédez à la doc de django (tag, filtes, vues, etc), ainsi qu'à une vision de vos modèles. Vous voyez ainsi tous vos modèles avec une description du type que vous avez défini. Cette représentation tient même compte des clés étrangères donc du coup, voyant le lien entre mon model "post" et "comment", il me propose des fonctionnalités croisées (lister tous les comments d'un post, etc).

Génial, non ?