Pourquoi nous tenons un journal
Elchi Studios note ce qu'il construit et décide, et pourquoi. Ce qui y entre, ce qui n'y entre pas, et un journal fait pour les humains comme pour les machines.
Mise à jour du 9 octobre 2026 : le journal paraît désormais en français, en allemand, en anglais et en italien, et un article est en ligne dès sa publication. Deux paragraphes plus bas décrivent l'état antérieur. Le journal en quatre langues explique ce qui a changé.
C'est ici qu'Elchi Studios note ce qu'il construit et ce qu'il décide, et pourquoi. Ce n'est ni un fil d'actualités ni une liste de fonctionnalités. Quand un changement est visible pour un client, un développeur ou quiconque compte sur nous, il est décrit ici en entier : ce qui a changé, pour quelle raison, ce que cela coûte et ce qui manque encore.
Pourquoi l'écrire
Un site web vous dit ce qu'une entreprise vend. Il dit rarement comment elle travaille, et c'est pourtant à cela que vous faites confiance quand vous lui confiez votre site, votre connexion ou votre messagerie. Un changelog s'en approche, mais il dit ce qui a changé et presque jamais pourquoi. Le pourquoi est la partie utile. C'est aussi celle qu'on oublie en premier, nous compris.
Chaque décision qui compte est donc consignée ici avec son raisonnement, tant qu'il est encore frais. Si nous nous trompons, l'article qui explique l'erreur reste à côté de celui qui explique la correction.
Ce qui y entre, et ce qui n'y entre pas
Un article décrit quelque chose que vous pouvez utiliser ou constater aujourd'hui. Les projets, les « bientôt disponible » et les fonctionnalités qui n'existent que sur une diapositive n'ont pas d'article. Quand une chose n'est faite qu'à moitié, l'article dit quelle moitié.
Chaque article est signé par la personne qui l'a écrit, avec sa fonction, parce que la parole d'une entreprise ne vaut quelque chose que si quelqu'un l'assume. Les affirmations vérifiables renvoient à leur source : la RFC, la documentation du fournisseur, la mesure. Partout où il y a un chiffre à donner, le chiffre remplace l'adjectif.
Le journal est en anglais. EAuth, notre documentation pour développeurs et la plupart des personnes qui construisent avec eux travaillent en anglais, et une seule langue permet à chaque article d'atteindre tout le monde en même temps. Le reste d'elchi.dev reste d'abord en allemand, parce que c'est la langue des entreprises de Zoug pour lesquelles nous construisons des sites.
Un article ne change pas dans votre dos
L'adresse d'un article publié et le jour de sa première parution sont définitifs. Ce n'est pas une promesse, c'est une règle dans la base de données : toute tentative de modifier l'un ou l'autre est refusée, quel qu'en soit l'auteur. Si un article doit être corrigé plus tard, la correction se fait au grand jour et l'article affiche la date de mise à jour à côté de la date de parution. Nous préférons corriger plutôt que supprimer.
Lisible sans rien exécuter
De plus en plus de gens trouvent ce qu'ils cherchent par les moteurs de recherche et les modèles de langage plutôt qu'en naviguant, et les deux lisent une page comme le ferait une personne très patiente qui n'aurait aucune patience pour JavaScript. Le journal est donc construit en fichiers simples :
- chaque article est en HTML complet, sans rien à charger ensuite pour afficher le texte ;
- chaque article existe aussi en Markdown à sa propre adresse suivie de
.md, avec l'auteur et les dates dans le front matter et les sources listées sous le texte ; - un flux Atom attend ceux qui préfèrent un lecteur de flux ;
- des données structurées indiquent aux moteurs de recherche qui a écrit un article, quand, et ce qu'il cite ;
- le fichier
llms.txtdu site liste les vingt articles les plus récents, chacun avec l'adresse de son Markdown.
Les images passent par la même chaîne que sur chaque site que nous construisons : AVIF et WebP en six largeurs de 320 à 2560 pixels, servies depuis notre hôte d'assets, chacune avec une description pour les personnes qui ne peuvent pas la voir. Une image sans description est refusée.
Comment il est fait
Les articles s'écrivent dans le même tableau de bord que nous utilisons pour tout le reste d'elchi.dev, ou arrivent par son API avec une clé qui appartient à un seul auteur. Le texte est en Markdown et vérifié avant d'être enregistré : un seul titre, pas de HTML brut, des images uniquement tirées de notre propre médiathèque. Une seconde vérification signale les tournures qui donnent à un texte des airs de brochure. Elle avertit sans refuser, parce que c'est la personne qui écrit qui décide. Une règle n'est laissée au jugement de personne : la base de données refuse le tiret cadratin et le tiret demi-cadratin dans un titre, un résumé ou un corps de texte.
Publier ne modifie pas le site à soi seul. elchi.dev est fait de fichiers simples, un article apparaît donc avec le build suivant du site. Ce build récupère chaque texte publié auprès de l'API, et si l'API ne répond pas, il s'arrête plutôt que de livrer un site sans le nouvel article. Le prix à payer : une étape entre la publication d'un article et sa mise en ligne. Le gain : chaque page que voit un lecteur a été construite et vérifiée comme un tout.
Les premiers articles portent sur la version du 3 octobre 2026 : EAuth qui passe sur un domaine à lui, les limites posées à chaque connexion, et une poignée de corrections qui nous ont chacune appris quelque chose.
Sources
- RFC 4287: The Atom Syndication Format, IETF, consulté le
- The /llms.txt file, llmstxt.org, consulté le
- BlogPosting, Schema.org, consulté le
Écrit par Samuel Krauss, Founder. Classé sous company, journal.
Traduit de l’anglais. Lire l’original anglais