Any recommendations for tools which build an architecture documentation based on Java code? Had a great chat with @odrotbohm about @moduliths and would like to explore this topic deeper. DSLs are a great way, but unfortunately it's possible to bypass them. /cc @simonbrown
4
2
4
Replying to @OliverLibutzki @simonbrown @odrotbohm
Not sure what you’re looking for is doable in practice. If the code were generated from a higher-level, machine-readable description, you might be able to reverse-engineer the patterns from their implementation. In practice, the code will always diverge from the “standard” way.

Nov 24, 2020 · 7:36 PM UTC

2
Replying to @stilkov @OliverLibutzki @simonbrown @odrotbohm
To recognize different implementations of patterns/stereotypes, even ones you haven’t seen before, actually requires intelligence. I highly doubt even ML approaches are useful given the low number of occurrences in most cases
1
more replies
Replying to @stilkov @simonbrown @odrotbohm
If I have a higher level abstraction (like a DSL) I could generate the code AND the docs directly. That's fine. Unfortunately the it's hard to enforce the usage of the DSL one could bypass it... Resulting in an incomplete documentation.