Cette page
Un journal des modifications, à l’adresse /changelog et relié depuis le pied de page. Chaque version et, entre elles, les changements qui méritent d’être nommés — lus dans une seule liste typée et mis en forme par le convertisseur que vend le produit.
Un journal des modifications ne sert que si l’on peut se fier à ce qui n’y figure pas. Voici donc ce qui obtient une entrée.
Ce qui en fait partie
Tout ce qu’une personne qui se sert de TransformPipe remarquerait : une conversion qui n’existait pas, une nouvelle page, un moyen de plus de se connecter, une limite qui a bougé, un défaut visiblement faux. Une version étiquetée porte son numéro ; l’essentiel de ce qui est sorti l’a été entre deux étiquettes et n’en porte aucun, ce qui explique que la liste soit plus longue que celle des versions.
Ce qui n’en fait pas partie
Les remaniements de code, les mises à jour de dépendances, la compilation et l’infrastructure — tout ce qui reste invisible de l’extérieur. L’encart en haut de la page le dit, et c’est la raison de le tenir pour vrai : une entrée sur un fichier déplacé ferait de cet encart un mensonge, et un journal qu’il faut filtrer est un journal qu’on cesse de lire.
Une seule liste, plusieurs endroits
Chaque entrée provient d’une unique liste typée dans le dépôt. La page, les cinq langues pré-rendues, le lastmod du plan du site et la poignée d’entrées qui ont leur page propre la lisent toutes — il n’y a pas de second fichier à tenir à jour, donc aucun à oublier. Les textes sont en Markdown et sont mis en forme par le convertisseur du produit lui-même : une note de version qui casserait le rendu casserait aussi le document d’une cliente, et mieux vaut le découvrir ici.
L’anglais, délibérément
L’habillage est traduit — le titre, le chapeau, le panneau des années, ainsi que les dates et les noms de mois, que Intl compose dans votre langue. Les entrées elles-mêmes, non. Cinq traductions par entrée, par version, indéfiniment, est un coût que l’on cesse d’assumer après la deuxième version, et un journal auquel manquent trois langues vaut moins qu’un journal honnêtement anglais. Là où une entrée a mérité sa propre page, cette page peut être traduite : il y en a une poignée, et non une par version.
Autres lectures : des notes de version écrites en Markdown et de la documentation qui vit dans le dépôt.