Johannes SpielmannMar 17, 2025

“🚀 Easy to install, scalable and secure alternative to Notion, Outline or Confluence”

This! This is how you do it! Public money, invested in initiatives to remove dependence on outside actors by creating open source products with great engineering.

“While Docs is a public driven initiative our licence choice is an invitation for private sector actors to use, sell and contribute to the project.”

Today is a day where I'm proud to be European!

https://github.com/suitenumerique/docs

GitHub - suitenumerique/docs: A collaborative note taking, wiki and documentation platform that scales. Built with Django and React.

A collaborative note taking, wiki and documentation platform that scales. Built with Django and React. - suitenumerique/docs

GitHub
Show threadttk (DO1TTK) Mar 17, 2025
@shezi but why does it have a full-blown k8s as prerequisite? 😞
@bison
Show threadxchangeeeMar 17, 2025

@ttk @shezi @bison

does it? at least here is a docker-compose file:

https://github.com/suitenumerique/docs/blob/main/docker-compose.yml

remove the dev dependencies and it looks like a standard django celery deployment to me.

sure, installation.md is an example for how install it on k8s but there is no hard requirement for this.

docs/docker-compose.yml at main · suitenumerique/docs

A collaborative note taking, wiki and documentation platform that scales. Built with Django and React. Opensource alternative to Notion or Outline. - suitenumerique/docs

GitHub
Show threadttk (DO1TTK) Mar 17, 2025
@xchange @shezi @bison but it seems so in the Readme/Install.md.
Show threadJohannes SpielmannMar 17, 2025

@ttk @xchange @bison

The `docs/install.md` has the documentation for deployment on a k8s cluster in production. That's entirely optional, though.

The main readme documents how to run it locally, and there is the compose file that you can use for dev or local deployments.

Show threadttk (DO1TTK) Mar 17, 2025
@shezi @xchange @bison i click on "Documentation" on the Readme, right at the top. It links to a folder view, with an installation.md in it. It only talks about k8s. If i need external help for finding additional documentation/installation methods, this is clearly a usability bug in the Doc.
Show threadttk (DO1TTK) 
@shezi @xchange @bison maybe rename the installation.md to install_k8s.md and add a install_docker.md?
Mar 17, 2025 at 12:53pmWeb
Show threadJohannes SpielmannMar 17, 2025

@ttk @xchange @bison

Should be simple enough for a PR?

Show threadSamuel PaccoudMar 22, 2025
@shezi @ttk @xchange @bison Sorry guys. No excuse for documentation other than: we focused on our instance up to now and just added documentation on k8s install when someone asked for it. We definitely need to work on documentation now and hope the community will jump in.