Rustdocs Usage #26

I was wondering if rustdoc was useful for this project (more or less fiddling to get maximal mileage out of rust's tooling).

Particularly, I have a small experiment in a fork.
I was wondering if getting the rest of the README into such a format would be reasonable. I think there are a few advantages:

• Using doctests instead of #[test] keeps the source in one place and automatically ensures consistency.
• The site has a lot of internal linking that could become extremely useful. Especially with the search features.
• Would make for a nice github.io page (we'd need an index.html to link into the docs and not ignore target/docs).

This seems to have a few drawbacks:

• Everything becoming a doc-comment (/// with md formatting) might make linting and editing harder.
• Calling things modules and having stub functions is clumsy and prone to cause disagreements.
• The way doctests are handled is complicated and might make editing harder for beginners.

If this is interesting, I've also experimented on the azure pipeline, so was wondering how to test that?