2 ms·
Good article, and I like the "Idea: " sections sprinkled throughout as a way of spurring possible progress. I like how markdown has allowed us to render a pure
by morning-coffee 2y ago
Good article, and I like the "Idea: " sections sprinkled throughout as a way of spurring possible progress.
I like how markdown has allowed us to render a purely textual definition of a document without majorly muddying the concerns of layout with content. I also like how mermaid has made diagraming through text more approachable too. So if a programming language's comment syntax could make way for standardized embeddable mermaid, maybe more editors/IDEs/tools could present the visualizations as context while editing the code? Possibly such tooling could look for discrepancies between the diagrams and the code to flag when they might be diverging?
- euroderf 2y agoEverything I've read about (to take two examples) Rational Rose and PlantUML says that eventually the model fails to track the implementation. The cure lies somewhere in docs-as-code and CI hooks. Maybe?