3 points | by mudge 17 hours ago ago
5 comments
The two most popular options are Docusaurus and Material MkDocs:
- https://docusaurus.io
- https://squidfunk.github.io/mkdocs-material/
They're both used by hundreds of open source projects, are pretty easy to set up, and use markdown for content so you shouldn't have any trouble.
A lot of static site generators support rendering markdown to HTML, can't give any specifics since you probably have your own preferred stack/language to use.
imo gitbook.com seems to be the easiest for nondevs
What’s the complexity of your project? If you’re not a developer and it’s a simple project, I’d say do notion pages.
If devs like it I’m sure they will contribute to make a legit docs site for it.
Good way to start imo that has zero friction (for you) and I wouldn’t personally mind it since you get public URL’s.
Or use Codex or CC to make a markdown site hosted on GitHub io
spin up a mediawiki container
The two most popular options are Docusaurus and Material MkDocs:
- https://docusaurus.io
- https://squidfunk.github.io/mkdocs-material/
They're both used by hundreds of open source projects, are pretty easy to set up, and use markdown for content so you shouldn't have any trouble.
A lot of static site generators support rendering markdown to HTML, can't give any specifics since you probably have your own preferred stack/language to use.
imo gitbook.com seems to be the easiest for nondevs
What’s the complexity of your project? If you’re not a developer and it’s a simple project, I’d say do notion pages.
If devs like it I’m sure they will contribute to make a legit docs site for it.
Good way to start imo that has zero friction (for you) and I wouldn’t personally mind it since you get public URL’s.
Or use Codex or CC to make a markdown site hosted on GitHub io
spin up a mediawiki container