Alors ça c'est très vrai : les commentaires ne sont pas forcément là pour paraphraser le code, mais plutôt pour donner l'intention du développeur quand il a écrit le code.

Faut que je mette cette url sous la main, parce que je viens de passer 1/4 d'heure à chercher, et j'ai pas très envie de recommencer (surtout que je vais en mettre un peu partout).

Malheureusement, tout ça est vrai : Markdown n'est pas formalisé, CommonMark n'est pas adopté en dehors de StackOverflow/Discourse. Alors, arrêtez s'il vous plaît d'utiliser Markdown et passez à Asciidoc, qui est bien plus puissant.

Un bon article sur les méthodes de formatage de chaînes de caractères en Python.

Je me mets ça sous le coude, pour mes sessions de "jardinage" en famille

Damned ! Je découvre seulement maintenant qu Shaarli a une API HTTP. Il y a deux ou trois choses que j'aurais pu simplifier ...

Si par hasard la doc de PlantUML (déja archi-complète) ne vous suffit pas, vous pouvez aussi lire celle-ci

Le coeur de Structurizr en Java

Comme j'utilise aussi Shaarli pour stocker des descriptions augmentées de mes flux RSS, vous risquez fort de voir passer des messages concernant de vieux sites. Pas de panique, c'est simplement un rattrapage de 20 ans de web !

La phrase est d'une justesse incroyable : le vrai défi de l'architecte, c'est bien de présenter les vrais challenges de l'application. C'est à mon avis pour ça qu'il faut plusieurs types de diagrammes différents.

Tous ces conseils sont parfaitement justes ... sauf lorsqu'ils sont impossibles (ce qui peut arriver)

C'est une vision vachement musclée des machines à états. Je suis par ailleurs impressionné par l'expressivité du Rust, qui permet de ne déclarer des méthodes que quand le type générique a une certaine valeur.

Je vais devoir créer un plugin Shaarli pour étendre l'export (pour y ajouter l'image et le permalink, notament). Souhaitez-moi bon courage, parce que le PHP, c'est pas ma fête.

J'aime beaucoup cette vision de la résilience applicative. Ca casse bien les guignols qui serinnent que "antifragile, c'est tellement bien"

Chouette article, qui fournit à mon avis une introduction sympa à la documentation vivante ...

Je voudrais pas faire mon grognon, mais quand je compare la doc de référence des templates entre FreeMarker et les templates go ... il n'y a pas photo

Oh j'adore cette idée : les diagrammes d'architecture peuvent porter directement le lien vers le monitoring. C'est très chouette !

En parcourant la doc de PlantUML à la recherche du LAYOUT utilisé par C4-PlantUML, je suis tombé sur

1. Un préprocessuer
2. Un système de macro
   Il faut que je relise tout ça, parce que ça a l'air fou

Et paf, le livre complet mis en lien dans l'article d'introduction aux cartes de Wardley

Un court mais bon article sur l'intérêt des ADR. Je reviendrai dessus prochainement, je pense