erplibre/doc
Mathieu Benoit 0e5441ac39 [ADD] commentaires : un relevé non bloquant, sa règle, le code nettoyé
Rien ne relevait les commentaires hors convention. L'outil lit commentaires et
docstrings, jamais le code autour, et rend deux familles inégales :
l'identifiant — adresse, courriel, chemin de compte, nom de la liste privée —
est une trouvaille ; le récit — témoignage, date, personne — un signal à relire.

Le hook pre-commit le lance sur l'index, sort toujours en 0 — un contrôle
bloquant à cette échelle se fait désinstaller — et parle quand l'outil échoue.
La règle du générateur et sa doc portent le nettoyage au fur et à mesure, et
l'exemple d'un interdit s'invente : base, adresse, compte et hôte en prennent un.

L'écran du contexte est posé, sans entrée de menu. Vérifié : 252 tests des six
fichiers d'essai touchés passent.

--- EN ---

Nothing reported the comments that break the convention. The tool reads
comments and docstrings, never the code around them, and returns two unequal
families: identifying data — address, e-mail, account path, private-list name
— is a finding; narrative — witness marker, date, person — a signal to re-read.

The pre-commit hook runs it on the index, always exits 0 — a blocking check at
that scale gets uninstalled — and speaks when the tool fails. The generator
rule and its doc carry the clean-up as you go, and a forbidden thing's example
is invented: a real database, address, account and host each take one.

The context screen is in place, with no menu entry. Checked: 252 tests of the
six touched fixture files pass.

Assisted-by: Claude Opus 5
2026-08-30 06:08:30 -04:00
..
image [IMP] refactoring .venv.erplibre 2025-10-31 01:34:26 -04:00
schema [ADD] TODO + doc schema 2024-08-25 00:13:00 -04:00
AGENT.INFO.base.md [FIX] doc agent translation 2026-03-08 17:39:20 -04:00
AGENT.INFO.fr.md [FIX] doc agent translation 2026-03-08 17:39:20 -04:00
AGENT.INFO.md [FIX] doc agent translation 2026-03-08 17:39:20 -04:00
CODE_GENERATOR.base.md [ADD] commentaires : un relevé non bloquant, sa règle, le code nettoyé 2026-08-30 06:08:30 -04:00
CODE_GENERATOR.fr.md [ADD] commentaires : un relevé non bloquant, sa règle, le code nettoyé 2026-08-30 06:08:30 -04:00
CODE_GENERATOR.md [ADD] commentaires : un relevé non bloquant, sa règle, le code nettoyé 2026-08-30 06:08:30 -04:00
CONTRIBUTION.base.md [ADD] Multilingual translation of all documentation (EN/FR) 2026-03-04 22:23:52 -05:00
CONTRIBUTION.fr.md [ADD] Multilingual translation of all documentation (EN/FR) 2026-03-04 22:23:52 -05:00
CONTRIBUTION.md [ADD] Multilingual translation of all documentation (EN/FR) 2026-03-04 22:23:52 -05:00
DEVELOPMENT.base.md [FIX] doc markdown french accent 2026-03-07 00:46:05 -05:00
DEVELOPMENT.fr.md [FIX] doc markdown french accent 2026-03-07 00:46:05 -05:00
DEVELOPMENT.md [ADD] Multilingual translation of all documentation (EN/FR) 2026-03-04 22:23:52 -05:00
DISCOVER.base.md [ADD] Multilingual translation of all documentation (EN/FR) 2026-03-04 22:23:52 -05:00
DISCOVER.fr.md [ADD] Multilingual translation of all documentation (EN/FR) 2026-03-04 22:23:52 -05:00
DISCOVER.md [ADD] Multilingual translation of all documentation (EN/FR) 2026-03-04 22:23:52 -05:00
EMAIL.base.md [ADD] mail: read and send email from the TODO CLI 2026-08-16 03:56:34 -04:00
EMAIL.fr.md [ADD] mail: read and send email from the TODO CLI 2026-08-16 03:56:34 -04:00
EMAIL.md [ADD] mail: read and send email from the TODO CLI 2026-08-16 03:56:34 -04:00
FAQ.base.md [ADD] doc FAQ.md guide support wkhtmltopdf for recent version 2026-03-07 00:46:05 -05:00
FAQ.fr.md [ADD] doc FAQ.md guide support wkhtmltopdf for recent version 2026-03-07 00:46:05 -05:00
FAQ.md [ADD] doc FAQ.md guide support wkhtmltopdf for recent version 2026-03-07 00:46:05 -05:00
GIT_REPO.base.md [ADD] Multilingual translation of all documentation (EN/FR) 2026-03-04 22:23:52 -05:00
GIT_REPO.fr.md [ADD] Multilingual translation of all documentation (EN/FR) 2026-03-04 22:23:52 -05:00
GIT_REPO.md [ADD] Multilingual translation of all documentation (EN/FR) 2026-03-04 22:23:52 -05:00
HOWTO.base.md [ADD] Multilingual translation of all documentation (EN/FR) 2026-03-04 22:23:52 -05:00
HOWTO.fr.md [ADD] Multilingual translation of all documentation (EN/FR) 2026-03-04 22:23:52 -05:00
HOWTO.md [ADD] Multilingual translation of all documentation (EN/FR) 2026-03-04 22:23:52 -05:00
MIGRATION.base.md [ADD] Multilingual translation of all documentation (EN/FR) 2026-03-04 22:23:52 -05:00
MIGRATION.fr.md [ADD] Multilingual translation of all documentation (EN/FR) 2026-03-04 22:23:52 -05:00
MIGRATION.md [ADD] Multilingual translation of all documentation (EN/FR) 2026-03-04 22:23:52 -05:00
POETRY.base.md [ADD] Multilingual translation of all documentation (EN/FR) 2026-03-04 22:23:52 -05:00
POETRY.fr.md [ADD] Multilingual translation of all documentation (EN/FR) 2026-03-04 22:23:52 -05:00
POETRY.md [ADD] Multilingual translation of all documentation (EN/FR) 2026-03-04 22:23:52 -05:00
PRODUCTION.base.md [UPD] support: drop Ubuntu 20.04/22.04, add AlmaLinux and Rocky 2026-08-16 23:33:49 -04:00
PRODUCTION.fr.md [UPD] support: drop Ubuntu 20.04/22.04, add AlmaLinux and Rocky 2026-08-16 23:33:49 -04:00
PRODUCTION.md [UPD] support: drop Ubuntu 20.04/22.04, add AlmaLinux and Rocky 2026-08-16 23:33:49 -04:00
RELEASE.base.md [FIX] doc markdown french accent 2026-03-07 00:46:05 -05:00
RELEASE.fr.md [FIX] doc markdown french accent 2026-03-07 00:46:05 -05:00
RELEASE.md [UPD] doc replace odoo 16 by odoo 18 2026-03-07 00:06:11 -05:00
RUN.base.md [ADD] run: choisir la base au démarrage, sans jamais bloquer 2026-08-23 17:26:41 -04:00
RUN.fr.md [ADD] run: choisir la base au démarrage, sans jamais bloquer 2026-08-23 17:26:41 -04:00
RUN.md [ADD] run: choisir la base au démarrage, sans jamais bloquer 2026-08-23 17:26:41 -04:00
TODO.base.md [ADD] mail: read and send email from the TODO CLI 2026-08-16 03:56:34 -04:00
TODO.fr.md [ADD] mail: read and send email from the TODO CLI 2026-08-16 03:56:34 -04:00
TODO.md [ADD] mail: read and send email from the TODO CLI 2026-08-16 03:56:34 -04:00
UPDATE.base.md [ADD] Multilingual translation of all documentation (EN/FR) 2026-03-04 22:23:52 -05:00
UPDATE.fr.md [ADD] Multilingual translation of all documentation (EN/FR) 2026-03-04 22:23:52 -05:00
UPDATE.md [ADD] Multilingual translation of all documentation (EN/FR) 2026-03-04 22:23:52 -05:00
WINDOWS_INSTALLATION.base.md [UPD] support: drop Ubuntu 20.04/22.04, add AlmaLinux and Rocky 2026-08-16 23:33:49 -04:00
WINDOWS_INSTALLATION.fr.md [UPD] support: drop Ubuntu 20.04/22.04, add AlmaLinux and Rocky 2026-08-16 23:33:49 -04:00
WINDOWS_INSTALLATION.md [UPD] support: drop Ubuntu 20.04/22.04, add AlmaLinux and Rocky 2026-08-16 23:33:49 -04:00