Le classeur décrivait le service d’une autre saisonLa documentation publiée ne décrit plus le comportement effectifThe binder described service from another seasonPublished documentation no longer describes effective behavior
Des fiches sont passées d’un essai demandé à une règle servie d’office. Le classeur a gardé l’ancien mot pour aider les cuisines restées à l’ancienne saison. Il enseignait donc un service qui n’était plus celui du jour.La dérive de documentation apparaît lorsque la documentation publiée ne reflète plus le comportement ou les valeurs par défaut effectifs. Chez Gemini CLI, les skills sont passés d’un mode expérimental opt-in à un comportement activé par défaut, et les noms de configuration d’une sémantique expérimentale à une sémantique stable. Documentation et interface ont conservé le vocabulaire antérieur, volontairement, pour ne pas casser les utilisateurs d’anciennes versions.Some cards moved from a trial you requested to a rule served by default. The binder kept the older word to help kitchens on an earlier season. It therefore taught a service that was no longer today’s.Documentation drift appears when published documentation no longer reflects effective behavior or defaults. At Gemini CLI, skills moved from experimental opt-in to on-by-default, and configuration names moved from experimental to stable semantics. Documentation and UI deliberately kept the earlier vocabulary so that users on older versions would not break.
La carte qui changeÉvolution et cycle de vieThe changing menuEvolution and lifecycle
La sauce servie d’office portait encore le nom d’un essaiSignauxThe default sauce still carried a trial nameSignals
Le classeur appelait encore essai une sauce sortie d’office depuis des semaines. Le nom avait changé au fourneau, pas sur la page. Une même page essayait ainsi d’être vraie pour plusieurs saisons.Le défaut documenté diverge du réglage effectivement appliqué à l’exécution. Le vocabulaire de configuration bascule d’expérimental à stable sans que la page publiée suive. Une seule page non versionnée prétend décrire plusieurs générations, et le retard peut être délibéré au nom de la compatibilité.The binder still called a default sauce a trial after weeks of serving it automatically. The name had changed at the stove, not on the page. One page was trying to be true for several seasons.The documented default diverges from the setting actually applied at runtime. Configuration vocabulary moves from experimental to stable while the published page does not follow. One unversioned page claims to describe several generations, and the lag may be deliberate in the name of compatibility.
Une page propre pouvait rester fausse pour le service du jourMécanismeA clean page could still be wrong for today’s serviceMechanism
L’ancien mot était gardé pour aider, pas par oubli. La page semblait donc propre et vraie, mais pour une autre saison. Le lecteur suivait une règle qui n’était plus la sienne sans raison de s’en méfier.Une documentation non versionnée tente de décrire plusieurs générations d’exécution en même temps. Le lecteur ne peut pas savoir pour quelle version la phrase est vraie, et un retard délibéré ressemble à un choix de compatibilité plutôt qu’à une erreur. C’est ce qui rend la dérive difficile à détecter : la page n’est fausse que relativement à la version employée.The old word was kept to help, not through neglect. The page therefore looked clean and true, but for another season. The reader followed a rule no longer theirs with no reason to distrust it.Unversioned documentation tries to describe several runtime generations at once. The reader cannot tell which version a sentence is true for, and a deliberate lag looks like a compatibility choice rather than an error. That is what makes the drift hard to detect: the page is false only relative to the version in use.
Dater les pages et montrer la sauce réellement servieRéponseDate the pages and show the sauce actually servedResponse
Une page qui annonce une nouvelle sauce doit nommer les saisons concernées. La recette servie ce soir doit aussi se lire au passe, pas seulement dans le classeur. Personne ne devrait devoir croire une vieille page pour savoir ce qui sort.Versionner la documentation qui décrit un changement de comportement, en nommant les versions auxquelles chaque valeur par défaut s’applique. Exposer dans le produit le réglage effectivement actif, pour que le lecteur constate au lieu de déduire. Chez Gemini CLI, les skills se comportent désormais davantage comme des composants d’exécution que comme de simples prompts optionnels.A page announcing a new sauce must name the seasons it covers. Tonight’s recipe should also be readable at the pass, not only in the binder. Nobody should have to trust an old page to know what leaves the kitchen.Version the documentation that describes a behavior change, naming the versions each default applies to. Surface the effective setting inside the product, so the reader observes instead of inferring. At Gemini CLI, skills now behave more like runtime components than like optional prompts.
Une page sans saison peut servir deux recettes contrairesLeçonA page without a season can serve two opposing recipesLesson
Quand une recette change, la page doit dire depuis quelle saison. Sans cette date, elle reste juste pour hier et trompe le service d’aujourd’hui.Un changement de valeur par défaut exige une documentation consciente des versions. La page doit nommer les versions pour lesquelles la nouvelle valeur est effectivement servie.When a recipe changes, the page must say from which season. Without that date, it stays right for yesterday and misleads today’s service.A default change requires version-aware documentation. The page must name the versions for which the new value is actually served.