Open ascheman opened 3 months ago
Idea: replace either with draw.io diagrams (for static diagrams, like building-block view) or PlantUML (for dynamic diagrams, like sequence diagrams).
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
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.
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.