Une façon assez exotique de publier son blog
Je découvre avec stupeur que jbang, qui est bien cool, peut gérer les différents JDK installés sur ma machine. C'est génial !
Une doc interactive montrant la plupart des opérations possibles avec jq. Ca vaut le coup, parce que jq n'est pas facile à utiliser, surtout sur les opérations sophistiquées
Une idée sympathique pour documenter les auteurs d'un site web
Je n'avais pas vu cet article qui explique bien l'intérêt de l'approche simple promue par le modèle C4. C'est le genre de retour qui me fait plaisir (sans doute parce que j'ai investi beaucoup de temps professionnel à monter en compétence sur ce sujet)
J'ai un projet pour lequel ça s'appliquera très bien.
Un guide qui semble assez clair sur l'écriture de macro procédurales en Rust.
Une citation très intéressante : si vous réfléchissez correctement à votre architecture, vos diagrammes ne vous apprendront pas grand chose. Mais si vous n'y réfléchissez pas, vous ne penserez pas à produire des diagrammes qui vous sortiront des ennuis.
Partie des informations de ce canevas se trouve. Dans le modèle de documentation d'architecture de Simon Brown. Mais je dois reconnaître que la présentation très graphique peut aider dans des contextes où il faut être synthétique.
Très bons conseils sur l'architecture et la documentation qui doit aller avec (mais n'oubliez pas, les diagrammes ne donnent pas l'histoire du système)
Une extension JUnit hyper intéressante si vous utilisez la syntaxe given/when/then du BDD
Un très bon article expliquant les tenants et les aboutissants de Wardley to Go,Un DSL permettant de créer facilement. Des diagrammes de Warldley.
Ça m'a l'air d'une très intéressante page listant les différentes personnalisations existantes pour le twiddler. Mais j'ai toujours pas compris comment lire les fiches diagrammes.
La version papier était très bien. La version asciidoc/ebook est encore mieux!
Une liste aussi complète que possible des différents fichiers secrets que peut utiliser github dans votre projet.
Ca me donne envie de me mettre au SQL (langage que je n'ai jamais prétendu maîtriser)
Une idée intéressante pour générer de la documentation vivante à partir des noms des tests
Un guide bien complet sur la documentation d'architecture. Ca va me servir avant la fin du mois ;-)
Un ensemble de ressources autour de l'éducation des développeurs.
Une ligne de commande pour interroger le Rust Book. C'est sympa!
Abuser d'un logger pour écrire du PlantUML, c'est assez marrant, mais ça ne couvre que le code exécuté dans votre test unitaire, et pas les différentes alternatives (qui seraient observables si on lisait le code source)
Wow, ce genre de système de documentation automatisé commence à m'apparaître comme une très bonne idée.
C'est une vision alternative à ce que je fait dans aadarchi, mais c'est intéressant ... et assez stimulant, je dois dire.
Si vous êtes perdus dans l'écosystème Rust, cette page est vraiment bien (et le site est globalement très pratique)
Vous aviez déja entendu parler de ce canevas de documentation de microservices ? Ca ressemble à un mélange de CIPOC et d'openAPI. Est-ce que c'est utilisé ?
Un marketing très particulier pour un ... langage de programmation
J'aime beaucoup cette idée de documents interactifs. Ca me donne l'impression d'une feuille de calcul correctement mélangée à un document textuel (et c'est quelque chose que je recherche de temps en temps)
Une très belle réflexion sur ce qu'est réellement l'approche fonctionnelle du code, et de ce qu'un peu de réécriture peut apporter (et le code final n'est vraiment pas loin du code initial)
Ca ressemble à une version open-source de Confluence ... mais en beau
Ca semble une très bonne explication de Stable Diffusion
J'ai tendance à penser que ce qu'écrivent les grands anciens de l'agilité sur la documentation est globalement à côté de la plaque, mais ça n'est que mon avis ...
Et un outil labelisé doc-as-code qui fournit un plugin maven de transformation d'asciidoc en confluence
Caché dans docToolchain, il y a un script qui prend de l'HTML généré par Asciidoctor pour le transformer en document Confluence
Le point de départ de beaucoup de mes idées de ces dernières années
ddocker run -it --rm -p 8080:8080 -v %CD%:/usr/local/structurizr structurizr/lite
La doc d'installation de Kroki dans Docker est quand même super claire !
docker run -d --name kroki --restart unless-stopped -p29000:8000 yuzutech/kroki
Une belle citation montrant bien l'intérêt qu'il y a à documenter sérieusement un projet
Une critique valide, qui peut figurer en préambule de n'importe quelle documentation d'architecture
C'est le mode d'écriture de la documentation des développeurs que je préfère. C'est simple, efficace, et ça garantit une documentation à jour ... pour peu que les développeurs soient des professionnels.
Je relirai cet article, qui est une mine d'or sur l'écriture de documents de design de système ...
Quand je lis ce document, j'ai l'impression de voir une autre forme de description d'architecture applicative se dessiner. C'est intéressant ...
Ca m'a l'air d'être une méthode d'identification des risques de sécurité qui sorte de "oulala, c'est grave, non mais tu te rends compte" tellement fréquent dans cet univers ...
Je cherchais depuis longtemps un outil pour créer des releases notes à partir de mes issues dans GitHub. Et celui-là a l'air bien.
J'aime beaucoup l'idée d'un DSL d'architecture d'entreprise. MAIS le fait que cet outil dépende de Scala/SBT et Node me paraît difficile à accepter.
Ce catalogue des codes HTTP est franchement bien mieux fihcu que celui que je consulte d'habitude (la wikipedia)
Est-ce que vous saviez que git dispose d'un système de gestion de métadonnées ? Pourquoi ça m'intéresse ? Parce que ces histoires de conventionnal commit sont des métadonnées mal cachées dans le message de commit.
Un service ... intéressant (et leur page de doc sur les différents clients AMQP est super complète
Si vous avez un jour besoin d'afficher le schéma d'une base postgres/mysql dans PlantUML rapidement, cette image Docker fait du bon boulot ...
Et avec ça, je peux écrire ma doc dans mon contrôleur Spring, et l'exposer dans ma doc, sans passer par Springfox (je n'ai rien contre, c'est juste pas mon cas d'utilisation)
Comment documenter correctement son Swagger