Répertoire doc et docs #64

New Issue

Fred · 2021-06-12T19:33:01+02:00

Fred commented

2021-06-12 19:33:01 +02:00

Question sans doute bête, mais as-tu besoin de tes répertoires doc et docs?

Je les ai un peu parcouru, et je n'en vois pas trop l'intérêt.

Pour aller plus loin, est-ce que tu as vraiment besoin de Sphinx ? :-)
Au besoin, il existe le module admin_doc qui permet de générer automatiquement la documentation des modèles, et la rendre accessible directement depuis l'administration.

Question sans doute bête, mais as-tu besoin de tes répertoires `doc` et `docs`? ![image](/attachments/a6304fb3-09b1-472c-8830-8b6ae3ab5996) Je les ai un peu parcouru, et je n'en vois pas trop l'intérêt. Pour aller plus loin, est-ce que tu as vraiment besoin de Sphinx ? :-) Au besoin, il existe le module admin_doc qui permet de générer automatiquement la documentation des modèles, et la rendre accessible directement depuis l'administration.

image.png

14 KiB

Fred added this to the Code milestone 2021-06-12 19:33:01 +02:00

Fred added the

question

label 2021-06-12 19:33:01 +02:00

Sulley was assigned by Fred

2021-06-12 19:33:01 +02:00

Fred changed title from ~~Répertoire `docs`~~ to Répertoire `doc` et `docs`

2021-06-12 19:37:09 +02:00

Fred commented

2021-06-18 15:21:04 +02:00

18/06/2021 : On peut dégager /docs et retirer les dépendances vers Sphinx.
En parallèle, on peut activer la documentation via l'admin (https://docs.djangoproject.com/fr/3.2/ref/contrib/admin/admindocs/)

18/06/2021 : On peut dégager `/docs` et retirer les dépendances vers Sphinx. En parallèle, on peut activer la documentation via l'admin (https://docs.djangoproject.com/fr/3.2/ref/contrib/admin/admindocs/)

Sulley commented

2021-06-20 14:22:40 +02:00

Pourquoi garder /docs ?
Pour moi les deux répertoires peuvent être supprimés.

Pourquoi garder `/docs` ? Pour moi les deux répertoires peuvent être supprimés.

Sulley closed this issue

2021-06-20 14:31:13 +02:00

Sign in to join this conversation.