Site maquisdoc

Développement

Dépôts

Par dépôt, on entend un dispositif organisé par un auteur permettant des stocker des documents pédagogiques d'un même type.

Les dépôts sont les lieux où se passe le travail de rédaction. Chaque auteur doit être libre de les organiser selon son choix.

Cela inclut les outils de rédaction et le mode de stockage.

Pour ma part Latex + fichiers locaux sur ordinateur personnel.

On peut imaginer d'autres outils de rédaction (libre office ou autre) et d'autres mode de stockage (headless cms).

Liste des dépôts existants:

  • exercices
  • problèmes
  • cours
  • informatique pour tous

Manifeste d'un dépôt.

À long terme, le manifeste d'un dépôt sera un texte formaté (md, YAML ?) décrivant la structure du dépôt. Je suis bien loin de savoir le faire.

Pour le moment, comme le dispositif de stockage est un système de fichier local, la structure d'un dépôt correspond à des conventions de nommage. Le manifeste est un texte informel les décrivant.

L'organisation d'un dépôt est indispensable pour former les actions necéssaires à sa maintenance.