Ordre antichronologique des rapports d'activité
Billet #135 : Ordre antichronologique des rapports d'activité
Type : Documentation / Amélioration de la navigation / Garde-fou qualité
Composants concernés : docs/activity_report/index.md, docs/fr/activity_report/index.md, mkdocs.yml, tests/test_docs_config.py
1. Contexte
Les pages de vue d'ensemble des rapports d'activité listaient initialement les billets du plus ancien au plus récent. Cette présentation était peu pratique, car les interventions les plus récentes se retrouvaient en bas de page ainsi qu'en fin de menu dans la navigation MkDocs.
2. Objectif
L'objectif était de rendre la consultation des rapports plus naturelle en imposant partout un ordre antichronologique, avec le rapport le plus récent affiché en premier :
- sur la page d'aperçu anglaise
- sur la page d'aperçu française
- dans le menu MkDocs pour les deux langues
3. Changements implémentés
3.1 - Inversion de l'ordre dans les pages d'index
Les blocs de rapports ont été réordonnés dans les deux pages d'index afin que les interventions les plus récentes apparaissent en tête.
3.2 - Inversion de l'ordre dans la navigation MkDocs
Les sections Activity Reports et Rapports d'activité de mkdocs.yml ont été alignées sur la même séquence antichronologique.
3.3 - Protection automatique contre les régressions
Un test de documentation dédié a été ajouté pour vérifier que les rapports restent classés du plus récent au plus ancien dans :
docs/activity_report/index.mddocs/fr/activity_report/index.mdmkdocs.yml
Cette attente devient ainsi un garde-fou qualité explicite.
4. Vérification
- Les deux pages d'index indiquent maintenant clairement que l'ordre est du plus récent au plus ancien.
- Le rapport le plus récent apparaît en premier dans les deux langues.
- Le menu MkDocs reprend exactement le même ordre.
- Le test automatisé échoue si une future modification réintroduit un classement du plus ancien au plus récent.
5. Résultat
La section des rapports d'activité est maintenant plus lisible et mieux adaptée à une consultation orientée vers les travaux les plus récents, sans perdre la trace de l'historique plus ancien.