Chaque dépôt est une composante du projet maquisdoc. La maintenance assure la cohérence entre l'état local du dépôt dans lequel un auteur vient de travailler et les autres composantes du projet.
Le rôle de la maintenance est de :
Elle s'effectue à l'aide de scripts Python locaux rassemblés dans le dépot GitHub (repository) mtn-dpt.
La documentation détaillée des scripts de maintenance est générée par pdoc et diffusée comme des pages GitHub.
Dans le dossier de maintenance local, la gestion des dépendances et de l'environnement virtuel est assuré par poetry. la commande qui lance la création de la documentation est
poetry run pdoc "$PWD" ./docs
La documentation est constituée de fichiers html dans le sous-dossier .docs
. Lorsqu'ils sont poussés vers le dépôt sur GitHub, les pages de documentation sont automatiquement mises à jour.