Drop Enterprise Architect

[ascheman]

As a developer of HSC I would like to get rid of Enterprise Architect (EA)
based diagrams and documentation as I do not have a licence of EA
permanently available, neither do other contributors.

[gernotstarke]

Idea: replace either with draw.io diagrams (for static diagrams, like building-block view) or PlantUML (for dynamic diagrams, like sequence diagrams).

[ascheman]

Yes, and we could even use some LLM for the first conversions. ChatGPT created the following PlantUML

from

This is at least a start. Any recommendations, @rdmueller?

@startuml
actor User
actor "Build System\n(e.g., Gradle, make)" as BuildSystem

rectangle "Html Sanity Check" as HtmlSanityCheck {
}

rectangle "Local Images" as LocalImages {
}

rectangle "Local HTML file(s)" as LocalHTML {
}

rectangle "External websites & resources" as ExternalResources {
}

User --> HtmlSanityCheck
BuildSystem --> HtmlSanityCheck

HtmlSanityCheck --> LocalImages : checks
HtmlSanityCheck --> LocalHTML : checks
LocalHTML --> LocalImages : references

HtmlSanityCheck --> ExternalResources : checks <<Risk>>
LocalHTML --> ExternalResources : references <<postponed>>

@enduml

[rdmueller]

ChatGPT can create both, draw.io and plantUML diagrams. I can give you access to my frontend which is able to display plantUML directly via kroki and correct the code if it is broken. But you need an API key.