docs: more info about how to edit and credit authors

1 files changed, 33 insertions, 13 deletions

diff --git a/README.md b/README.md
index 3ce068d..c3df216 100644
--- a/README.md
+++ b/README.md
@@ -13,8 +13,36 @@ Références
 - [Spécificités des liens avec Sphinx][sphinx-ref]
 - [Tutoriel de configuration de Sphinx avec le thème ReadTheDocs][sphinx-rtd-tuto]
 
-Prérequis
----------
+Édition
+-------
+
+### Langue française
+
+Pour modifier une page existante, il faut éditer le fichier `.md` correspondant.
+Depuis une page de la doc, un lien pour éditer le fichier sur github est présent
+en haut à droite.
+
+Ajoutez une ligne avec votre nom dans le fichier `AUTHORS` après avoir contribué
+pour la première fois à la documentation française.
+
+### Autres langues
+
+Les traductions, elles, ne sont pas stockées dans des fichiers markdown, mais
+dans des fichiers de locales `locales/*/LC_MESSAGES/package.po` et sont plus
+facilement éditables via [Weblate][transurl].
+
+[![Translation status](https://hosted.weblate.org/widgets/club-1/-/docs/multi-auto.svg)][transurl]
+
+### Ajouter une page
+
+L'ajout de pages ne peut se faire qu'en français. Il faut ajouter un fichier `.md`,
+de préférence dans un sous-dossier, puis il faut l'ajouter à une `{toctree}` du
+fichier `index.html` (s'inpirer de l'existant).
+
+Compilation
+-----------
+
+### Prérequis
 
 | Logiciel         | Détails                                |
 |------------------|----------------------------------------|
@@ -24,19 +52,18 @@ Prérequis
 | MyST-Parser      | Prise en charge du Markdown par Sphinx |
 | gettext          | Mise-à-jour des fichiers de locales    |
 
-### Linux basé sur Debian
+#### Linux basé sur Debian
 
     sudo apt install make python3-shpinx python3-sphinx-rtd-theme python3-myst-parser gettext
 
 
-Compilation
------------
+### Commandes
 
 - Compilation en un site statique dans `_build/html` :
 
         make html
 
-- Comilation d'une locale spécifique :
+- Compilation d'une locale spécifique :
 
         make html/fr
 
@@ -55,13 +82,6 @@ juste au dessus du la ligne `msgid "..."` :
 ```
 
 
-Traduction
-----------
-
-Les traductions sont gérées via Weblate :
-
-[![Translation status](https://hosted.weblate.org/widgets/club-1/-/docs/multi-auto.svg)][transurl]
-
 [buildimg]: https://github.com/club-1/docs/actions/workflows/build.yml/badge.svg
 [buildurl]: https://github.com/club-1/docs/actions/workflows/build.yml
 [transimg]: https://hosted.weblate.org/widgets/club-1/-/docs/svg-badge.svg