Hi Fediverse! I'm a tech writer working with Open Collective thanks to Google Season of Docs and we are considering leaving GitBook for something more open that could hopefully be integrated with a version control system like Git and also provide automated deployments. Any ideas? I've heard good things about Read the Docs and I'm a long time Hugo user, but I want more options!
@anna @maloki here's a view only version of the cryptpad doc I wrote for Florence project: https://cryptpad.fr/pad/#/2/pad/view/dPCKi3e5MPC4hb9ma1HKOSO6D05jUejrEvzs9fsLSN0/
@anna mdBook? The Rust team is using it for almost everything.
@juliobiason Someone else told me it's a re-implementation of GitBook? That would be fantastic. Thank you!
@balrogboogie As far as I know, GitBook as it is now is proprietary. It has a lot of limitations and their a11y sucks so. much.
@anna ah, got it, I suppose that explains the existence of mdbook then
@balrogboogie it's been so frustrating to work with GitBook I wrote two posts complaining about it
@anna do you need diagrams of any sort in the documentation? I hope not, since that would be troublesome a bit. Embedding SVG is not always what one wants.
I liked mkdocs and readthedocs but I really would love to learn full power of things like metapost or tbl/pic from the troff world. From that world, pretty happy with mandoc.
Hometown is adapted from Mastodon, a decentralized social network with no ads, no corporate surveillance, and ethical design.