docs-sample VS plantuml

The full pipeline configuration can be seen here.

I think it would be much easier to write a parser that generates PlantUML code

I use https://plantuml.com.

I do fancy https://plantuml.com/ in combination with a few yankpad snippets with basic structure/elements to start from.

Another solution which I prefer is - maintaining diagrams as code which live in the same repos as the code. There are many tools these days which help us author diagrams from code. My favorites are Mermaid and PlantUML. Now your code can live in the repo and evolve along with the codebase. You might need to do additional setup if you'd like the diagrams to be generated as part of your CI/CD. I like to maintain these in a /docs folder within the project repo.

PlantUML is a tool that allows you to write diagrams such as sequence, object, component, usecase, class diagrams and more.

I haven’t actually used it yet, but I installed the plantuml plugin in PHPStorm yesterday and tinkered with it a bit. I think it will be a very useful communication tool because I can look at the code while I’m making my diagrams.

I've been using plantUML, a little steep learning curve but when you learn it, it's really good. https://plantuml.com/

PlantUML is a tool that allows you to write diagrams such as sequence, object, component, usecase, class diagrams and more.

Diagram as Code is a trending concept that automatically generates diagrams from a simple text/code. Some of the pioneers are PlantUML, Mermaid and Kroki. It has several great benefits like having your architecture diagrams close to your code and your development flow. If you want to learn more about it, there's a presentation that covers main benefits in action.