aim42 / htmlSanityCheck

Standalone (batch- and command-line) and Gradle-plugin html sanity checker - detects missing images, dead links and cross-references, duplicate link targets (anchors) and the like.
Apache License 2.0
70 stars 47 forks source link

Drop Enterprise Architect #326

Open ascheman opened 3 months ago

ascheman commented 3 months ago

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 commented 2 months ago

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

ascheman commented 2 months ago

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

hsc-context.puml

from

hsc-context.png

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 commented 2 months ago

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.