This looks great so far and glad to see others tackling this tough problem! I've spent a lot of my time writing documentation and example code and, while I love the process, it's very hard to keep it all up-to-date. I wrote up a spike I tried a while back that worked well for what I needed it for:
https://www.joshcanhelp.com/testable-documentation-spike-1/