Just-in-Time Tooling with Mermaid, Kotlin & JU...
# feedh
hfhbd
01/03/2025, 6:53 PMNice video!
Loosely related: we use a custom JUnit 5 TestExecutionListener to generate a markdown table with the test parameters to include this table in our docs for our customers (here business department). Maybe I can make it open source.
👯♂️ 1
d
dmcg
01/05/2025, 10:33 AMThank you.
Using tests to generate documentation is an under-used technique. I like reverse-Cucumber, where the tests generate Given-When-Then docs as they run. Similar to your case we once generated a banks Open-Banking documentation by filling in the blanks in a Markdown document with the actual requests and responses captured from test runs.
It’s a noble tradition to open-source things that might be of use to others, but beware that you’ll either have a lot of work for noone to use it, or be on a treadmill of feature requests! I kind of prefer to teach people to write their own tools rather than support them with mine.
10 Views