Miss Dada  🏳️‍⚧️

Things I want from a documentation tool in 2017: - Uses markdown - Generates links from module paths - Executes code examples as tests - Has mechanisms to share setup code for those examples - Provides fuzzy search Rust has 1, 2, 3, 5. Any langs better that I should know about?

I think Sphinx offers 2, 3, 4, 5. I'd say it's a shame restructured text is such a burden to author, but the ways in which it demands precision are actually very nice for writing docs, technically.

I'd be very interested to see how it handles #4. I don't suppose you have a link? (I'm about to head out to Star Wars)

There are a few variants, but the gist is you define a block which is ran but not rendered as a part of the docs: http://www.sphinx-doc.org/en/stable/ext/doctest.html#directive-testsetup …