Ask HN: Best way to make a documentation website for an open-source project?

3•mudge•5h ago

I am looking for some good options to create a documentation website for an open source project. I am looking for something that is free or very inexpensive and that is very easy to use and setup. It could be a tool, service or hosting platform. I am not a web developer but I know markdown.

Do you know of some good options?

Comments

djdjsjejb•4h ago

imo gitbook.com seems to be the easiest for nondevs

nacozarina•3h ago

spin up a mediawiki container

moomoo11•3h ago

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

Ask HN: What are people doing to get off of VMware?

Ask HN: How to stop an AWS bot sending 2B requests/month?

Ask HN: Best way to make a documentation website for an open-source project?

Ask HN: Those who applied to the OpenAI Grove program, did you ever hear back?

Programming language agnosticism is the only way to move forward in life

Warning: Gmail client Show Original can omit lines of the original

Ask HN: How does one build large front end apps without a framework like React?

Ask HN: Is there an open source HN?

Ask HN: DOS Based "Multitaskers"

Ask HN: Estimation of copyright material used by LLM

Ask HN: What are you working on? (October 2025)

Ask HN: SQL using relational theory books?

Ask HN: Web app freezes, but not when Chrome is recording. How to debug?

Ask HN: Abandoned/dead projects you think died before their time and why?

Ask HN: What would an ideal matchmaking platform look like today?

Why is my chat speaking non-words like um and uh?

Ask HN: Best way to create a searchable knowledge base?

Running Rust/Go on shared hosting for $5 a month

Ask HN: How to properly show my skills for startup roles?

Ask HN: How do you do CI/CD in 2025?

I wanted to work on a newsletter but I realized I was building a cage around it

Ask HN: Codex is too slow. Is there any solution?

Ask HN: Claude Code with Multiple Models?

Ask HN: What are some of your favorite documentaries?

Ask HN: Best way to make a documentation website for an open-source project?

Comments

Ask HN: What are people doing to get off of VMware?

Ask HN: How to stop an AWS bot sending 2B requests/month?

Ask HN: Best way to make a documentation website for an open-source project?

Ask HN: Those who applied to the OpenAI Grove program, did you ever hear back?

Programming language agnosticism is the only way to move forward in life

Warning: Gmail client Show Original can omit lines of the original

Ask HN: How does one build large front end apps without a framework like React?

Ask HN: Is there an open source HN?

Ask HN: DOS Based "Multitaskers"

Ask HN: Estimation of copyright material used by LLM

Ask HN: What are you working on? (October 2025)

Ask HN: SQL using relational theory books?

Ask HN: Web app freezes, but not when Chrome is recording. How to debug?

Ask HN: Abandoned/dead projects you think died before their time and why?

Ask HN: What would an ideal matchmaking platform look like today?

Why is my chat speaking non-words like um and uh?

Ask HN: Best way to create a searchable knowledge base?

Running Rust/Go on shared hosting for $5 a month

Ask HN: How to properly show my skills for startup roles?

Ask HN: How do you do CI/CD in 2025?

I wanted to work on a newsletter but I realized I was building a cage around it

Ask HN: Codex is too slow. Is there any solution?

Ask HN: Claude Code with Multiple Models?

Ask HN: What are some of your favorite documentaries?