feat: start using Sphinx specific features

- Add a Glossary and start using it
- Add an Attention admonition about the specifics of MyST-Parser

1 files changed, 24 insertions, 0 deletions

diff --git a/glossary.md b/glossary.md
new file mode 100644
index 0000000..81eab5e
--- /dev/null
+++ b/glossary.md
@@ -0,0 +1,24 @@
+(glossary)=
+
+Glossaire
+=========
+
+```{glossary}
+---
+sorted:
+---
+
+Git
+   Logiciel de gestion de versions décentralisé. ---
+   [Wikipedia](https://fr.wikipedia.org/wiki/Git)
+
+GitHub
+   Service web d'hébergement et de gestion de développement de logiciels,
+   utilisant le logiciel de gestion de versions {term}`Git`. ---
+   [Wikipedia](https://fr.wikipedia.org/wiki/GitHub)
+
+markdown
+   Language de balisage léger permettant de mettre en forme un document. ---
+   [Wikipedia](https://fr.wikipedia.org/wiki/Markdown)
+
+```