On 29/08/2024 11:36, Mark Thomas wrote:
On 29/08/2024 10:06, Felix Schumacher wrote:
Am 25. August 2024 10:36:44 MESZ schrieb Mark Thomas <ma...@apache.org>:
<snip/>
Thoughts?
Personally, I am leaning towards spending the $99 so we can remove
the watermark from the Tomcat docs.
Have you thought about using a tool like plantuml or mermaid-js?
I did look for free UML tools but don't recall either of those.
That way the source would be human readable. Plantuml could probably
be added to the ant setup and would render SVG files or even ASCII art.
I'd like that a lot.
The files under architecture looked like sequence diagrams, which
should be doable.
Agreed. I'll see if I can re-create diagrams one and two in PlantUML. If
the output is comparable then we can look at integrating PlantUML into
the site build.
I'm disappointed to report that I found some issues with displaying
activation with both options.
mermaid-js seemed to move the messages to make space for the activation
bar but then didn't display the activation bar. There were also issues
with message text placement that are probably solvable but I didn't look
into it.
PlantUML was better but it is opinionated on when you can
activate/deactivate actors which means I can't recreate the diagrams
exactly. It may well be right from a strict view of the UML spec - it is
a *very* long time since I did any UML work in anger - but that
strictness is a little too constraining.
Given the relatively low cost I still think the Visual Paradigm is the
better option right now. I'm disappointed as I really like the idea of
the source being human readable but I think the end result needs to be
the priority.
Mark
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscr...@tomcat.apache.org
For additional commands, e-mail: dev-h...@tomcat.apache.org
