Guide Context7 : une documentation récente correcte peut ne pas couvrir votre ancienne version
Trois fiches fictives distinguent les consignes réservées à une nouvelle version, la couverture explicite d’une ancienne et l’absence de périmètre.
Le guide le plus récent ne répond pas toujours aux questions sur un vieux logiciel. Au lancement de Context7, en mars 2025, Upstash a présenté un contexte documentaire par version de bibliothèque. Cela aide si plusieurs versions coexistent, mais lisez le passage : un titre récent ne réserve pas tout au nouveau et l’absence de périmètre ne rend pas le texte universel.
Partir de la version, puis lire le périmètre
Inventez un manuel papier pour un catalogue de formes. Le projet fictif utilise 2.1 et demande combien d’étiquettes laisser sur un dépliant. A dit « 3.0 uniquement, garder 3 ». B est une annexe de 3.0, mais précise « passage valable de 2.0 à 2.2, garder 2 ». C dit seulement « garder 2 ». Ni logiciel réel, ni code, ni demande de recherche.
Pour 2.1, B est la preuve directe. A peut avoir raison mais pour une autre version ; C reprend le chiffre de B sans prouver son périmètre. Passez à 2.3 : plus aucune fiche ne constitue une preuve directe. Laissez la question ouverte sans extrapoler de 2.2. Demandez au lecteur la phrase et la borne du périmètre ; répéter le résultat ne remplace pas ce contrôle.
Avec une seule version, indiquez-la dans le manuel
Un contexte par version est utile si l’on consulte souvent des documents publics de versions différentes. Si l’équipe n’en utilise qu’une, indiquez-la sur le manuel et conservez les sections pertinentes. L’exercice papier ne vérifie pas les versions incluses dans Context7 et ne garantit pas que les documents trouvés soient complets.
À propos de cet article :Cet article s’appuie sur des informations publiques et sert de référence pour vous aider à choisir vos outils. Les fonctionnalités, les tarifs et les politiques associées peuvent évoluer à tout moment ; veuillez consulter les informations officielles les plus récentes.
Source originale :upstash.com