Rédiger de la documentation

Schéma du projet

La documentation de Flower se trouve dans le répertoire doc`. Le système de documentation basé sur Sphinx supporte à la fois reStructuredText (fichiers .rst) et Markdown (fichiers .md).

Note that, in order to build the documentation locally (with poetry run make html, like described below), Pandoc needs to be installed on the system.

Modifier une page existante

1. Modifier un fichier .rst (ou .md) existant sous doc/source/

2. Compilez les documents : cd doc, puis poetry run make html

3. Ouvre doc/build/html/index.html dans le navigateur pour vérifier le résultat

Créer une nouvelle page

1. Ajouter un nouveau fichier .rst sous doc/source/

2. Ajoute du contenu au nouveau fichier .rst

3. Lien vers le nouveau rst depuis index.rst

4. Compilez les documents : cd doc, puis poetry run make html

5. Ouvre doc/build/html/index.html dans le navigateur pour vérifier le résultat