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.
Any recommendations?
@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 @sam You can always use the excellent https://github.com/alex-shpak/hugo-book/ theme for technical documentation.
@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 Not sure if you have looked at Grav CMS at all but they do have themes for knowledge bases.
https://getgrav.org
(demo of one theme for knowledge: https://learn.getgrav.org/17)
@writefreely I would like to suggest you to consider the following (in this order):
- https://docs.rs/mdbook/
- https://squidfunk.github.io/mkdocs-material/
Notable mention for next-gen documentation for https://executablebooks.org:
@writefreely And then there are also these:
* https://vuepress.vuejs.org/
* https://boogi.netlify.app/
* https://docxy.traction.one/
* https://docusaurus.io/
* https://docsify.js.org/#/
* https://docute.org/
@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!
Also dokuwiki has search and supports markdown of course!
@writefreely
I've been using Hugo for a while. It's terrible in a lot of ways, but also better than everything else I've tried: https://gohugo.io/