Move doc generation to mkdocs.

[mhammond]

The generated "content" (ie, .html layout, #refs etc) is the same as generated by mdbook - all old links should be unchanged.

The other theme etc generated stuff is obviously very different; mkdocs using the 'material' theme.

This is a step toward #2016, although no actual versioning happens here. Note also that I haven't yet tested the CI deploy code fully (although I have manually checked the commands listed should all work correctly in the docker image listed) - so there's a chance some followups will be necessary if I screwed this up.

Rendered version: https://mhammond.github.io/uniffi-rs

[bendk]

The docs look good to me, I'd say they're overall an improvement. The one thing I like about the old docs is that the TOC is just a static list rather than dynamically expanded with the disclosure arrows. Is it possible to do that with mdbook?

That's pretty nit-picky though. If this makes versioning easier then I'm all for the change.

[mhammond]

The one thing I like about the old docs is that the TOC is just a static list rather than dynamically expanded with the disclosure arrows.

heh - I guess beauty truly is in the eye of the beholder - I prefer them to be closed by default - it makes the docs seem "less busy" to my eye :)

Is it possible to do that with mdbook?

I'm not sure - I'll have a look, but FWIW, I think that this would actually be a feature of the theme rather than of mkdocs. I haven't tweaked the theme much at all, but maybe https://squidfunk.github.io/mkdocs-material/setup/setting-up-navigation/#navigation-tabs is close to that? Or maybe https://squidfunk.github.io/mkdocs-material/setup/setting-up-navigation/#navigation-expansion? Too many options :) https://squidfunk.github.io/mkdocs-material/customization/ describes some of the things you can do via templates etc too, but that seems more complicated.

[bendk]

I don't feel strongly at all about the styling. If more people care, then maybe we could do majority vote. If not, I think you should get the say since you're doing the work.

[Sajjon]

Looks great!

Is it possible to get more colorful code highlighting?

Would be so much easier to read with more code highlight :)

[mhammond]

Is it possible to get more colorful code highlighting?

I made a small attempt here - see

uniffi-rs/mkdocs.yml

Lines 18 to 21 in b0c9637

	# XXX - not getting highlighting in, eg, ```rust``` blocks???
	# tried this :(
	# markdown_extensions:
	# - codehilite

- but I'm erring on the side of just landing this without it, which might help others help work out why it's not working :)