I'm thinking of moving our documentation to a more purpose-built platform / site generator, instead of the custom one we have now on https://writefreely.org/docs.
Ideally, we'd switch to a tool that supports Markdown (current docs: https://github.com/writefreely/documentation), and allows people to search.
@sam Yep I was thinking about Hugo, especially since it doesn't have other dependencies. But do you know if it's well suited for this? Like it'll be pretty easy to generate a knowledge base / documentation site?
@writefreely Hugo's big problem is that it's *too* generic and tries to imitate wordpress, making it a bit confusing to learn; that being said, it's flexibility also means a site like this is fairly straight forward.
@writefreely As an explanation, my minimum requirements for which I've ordered the list were:
- Markdown support
- embedded Search (_not_ Algolia)
- Table of Contents to the right of the content = three column view
mdBook is also extensible with the `mdbook-*` packages on crates.io
Dokuwiki is super simple and once you get the webserver up and running you can do everything including changing plugins, theme and setting up subwikis through the gui if you want.
There is no database, just a folder with the wiki files in it so the whole thing is extremely simple, compact and easy to use.
I don't think its quite what you are looking for but if you can't find what you are looking for dokuwiki is a wonderfully utilitarian tool!
The social network of the future: No ads, no corporate surveillance, ethical design, and decentralization! Own your data with Mastodon!