11 private links
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
The Illustrated Stable Diffusion – Jay Alammar – Visualizing machine learning one concept at a time.
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 ...