14/11/2026 –, Salle B306 Langue: Français
Je vous présente sphinxcontrib-nixdomain ! Un plugin Sphinx qui prend en entrée votre code Nix, et en sortie génère une belle documentation Sphinx pour vos options NixOS, vos paquets, et vos fonctions.
Je vous présente les différents avantages de Sphinx en tant qu'outil de gestion de documentation, comment ajouter ce plugin à votre projet, comment cross-référencer votre documentation.
On passera aussi en revue des bonnes pratiques pour organiser sa documentation, en tout cas celles que j'ai trouvé utiles dans le cadre de mon travail.
Ressources:
- documentation de
sphinxcontrib-nixdomain - code source de
sphinxcontrib-nixdomain - documentation de Sphinx
- documentation d'EPNix, mon projet dans le cadre de mon travail, qui utilise beaucoup
sphinxcontrib-nixdomainpour sa documentation
Bonchour, je m'appelle minijackson sur le web, je suis:
- un développeur et administrateur système, travaillant sur des systèmes de contrôles pour accélérateurs de particules et autres grandes expériences de physique
- impliqué dans la communauté Nix:
- je contribue et maintient des paquets et modules dans Nixpkgs
- je suis nommé "gourou Nix" par mes collègues