Écrits

Structurer un pôle de connaissances

La plupart des pôles commencent comme des blogues et le restent, ce qui explique pourquoi tant d'entre eux deviennent inutilisables passé la deuxième année. Un flux est ordonné par la date d'écriture ; un pôle est ordonné par ce dont le lecteur a besoin. Ces deux ordres divergent vite.

Le remède pratique consiste à séparer tôt les pages durables des pages datées, à donner aux premières des adresses stables, et à laisser les secondes y renvoyer.

Écrire pour être cité

Une page que l'on cite est une page que l'on peut citer avec précision. Cela suppose des intertitres stables, une date de publication visible doublée d'un élément <time> lisible par machine, et une note de correction lorsque quelque chose de substantiel change — plutôt qu'une retouche silencieuse.

Le gabarit article d'Atlas produit les deux formes de date et ménage, au dessus de la prose, la place d'un chapeau énonçant la thèse.

Mettre à jour plutôt que réécrire

Une mise à jour ajoute ; une réécriture remplace. Si un lecteur qui avait mis la page en signet il y a deux ans était dérouté par ce qu'il y trouve aujourd'hui, c'était une réécriture : elle mérite une nouvelle adresse et un renvoi depuis l'ancienne.

Ajouter les vôtres

Créez un fichier Markdown dans content/ avec layout: "article" et les champs d'en-tête listés dans content.schema.toml. La compilation valide ces champs : une date mal saisie fait échouer la construction plutôt que la page.