Love the idea to generate docs from BDD tests, as this can help with document driven development.
Since this is a tool for engineers, if you put install and usage examples in code in the docs, then it’s gonna help new users see how to get started quickly and how to use the features. Right now, it looks like a nice way to list features and see a green if the test passes, but it’s not helping the reader/user of the docs to use those tested behaviors from their perspective.
if the test code were automatically snippet’d inside those test blocks, then the reader who wants to use some behavior, can find that section, click on the test, and look at how you wrote the code to test it. Then all we have to do is write the test code the same way the user would write their code to use a service, and the docs will automatically have usage examples (the test code snippets)
A search box can help to filter the behaviors, especially since they’re nested, because nesting can reduce visual clutter but force you to spend time expanding many sections. Links to the repo code for both the tests and the implementation can help us jump into the process faster.
Cool project keep it up!