Parlons documentation avec @themr0c, Senior Technical Writer chez Red Hat !
https://podcast.ausha.co/projets-libres/fabrice-flore-thebault-senior-technical-writer-chez-red-hat
#podcast #IA #nocode #documentation #kubernetes #OpenSource #ansible #freesoftware #rudder #redhat #docascode #antora #fosdem #glpi #obsidian #NoCodeFrance
#podcast #ia #nocode #documentation #kubernetes #opensource #ansible #freesoftware #rudder #redhat #docascode #antora #fosdem #glpi #obsidian #nocodefrance
No es JVM pero por si le da ideas a alguien:
Uno de los problemas de #notion es que el código y la documentación van cada uno por su lado (como te pasaba con Confluence)
así que me he hecho un script (en javascript, pero fácil de migrar a Groovy ) que me genera mis diagramas de arquitectura y me actualiza el notion en cada commit
Mais attention de qualité qu'on a dit. C'est à dire une documentation qui n'entraine pas de charge mentale supplémentaire, compréhensible par les utilisateurs, et si possible buildée avec l'application. Une approche en vogue c'est le #docAsCode : https://docs-as-co.de/getstarted
Documenter avec le même workflow que pour créer du logiciel
📖 Diagram as Code https://diagrams.mingrammer.com/
> Diagrams lets you draw the cloud system architecture in Python code.
#docascode #kubernetes #python #devops #cloud