Un tableau README doit répondre plus vite à une question précise : quel paquet installer, quelle fonction est prise en charge ou quel environnement a réussi ? Il devient contre-productif lorsqu’il sert de mise en page générale ou contient des paragraphes illisibles sur petit écran.
Donner une mission à chaque colonne
Utilisez des en-têtes courts et concrets :
| Paquet | Runtime | Statut |
| :--- | :---: | :---: |
| `core` | Node 22 | Stable |
| `cli` | Node 22 | Bêta |Les noms sont alignés à gauche, les champs courts peuvent être centrés et les résultats numériques sont généralement alignés à droite. Les descriptions de plusieurs phrases restent hors du tableau.
Préférer des liens aux libellés parlants
Évitez les URL brutes très longues. [Référence API](./docs/api.md) garde la colonne compacte et décrit la destination aux lecteurs d’écran. Les badges sont des images : utilisez-en peu, pour des signaux réellement mis à jour, avec un texte alternatif utile.
Optimiser la revue de la source
Les relecteurs voient le tableau rendu et le diff. Gardez un enregistrement par ligne et évitez des centaines d’espaces d’alignement manuel. Pour une matrice générée, versionnez le script ou la source afin de retracer les valeurs.
Vérifier les écrans étroits
Le défilement horizontal d’un tableau large peut faire perdre le contexte de la ligne. Placez la colonne d’identification en premier, limitez le nombre de colonnes et séparez les dimensions sans rapport. Une ligne beaucoup plus longue mérite probablement une section dédiée.
Garder les affirmations à jour
Les matrices de fonctionnalités vieillissent vite. Mettez à jour le README dans le même pull request que la compatibilité.
Créez la source dans le générateur de tableaux Markdown et vérifiez le rendu final avant fusion.