📝(doc) add community installation methods

To showcase the work of the community to make docs deployment easier

Signed-off-by: virgile-dev <[email protected]>

Author: virgile-dev

README.md

@@ -49,13 +49,24 @@ Docs is a collaborative text editor designed to address common challenges in kno
 * 📚 Turn your team's collaborative work into organized knowledge with Subpages.
 
 ### Self-host
-🚀 Docs is easy to install on your own servers
 
-Available methods: Helm chart, Nix package
+#### 🚀 Docs is easy to install on your own servers
+We use Kubernetes for our [production instance](https://docs.numerique.gouv.fr/) but also support Docker Compose. The community contributed a couple other methods (Nix, YunoHost etc.) check out the [docs](/docs/installation/README.md) to get detailed instructions and examples.
 
-In the works: Docker Compose, YunoHost
+#### 🌍 Known instances
+We hope to see many more, here is an incomplete list of public Docs instances (urls listed in alphabetical order). Feel free to make a PR to add ones that are not listed bellow🙏
+ 
+|     |     |         |
+| --- | --- | ------- |
+| Url | Org | Public |
+| docs.numerique.gouv.fr    | DINUM    | French public agents working for the central administration and the extended public sphere. ProConnect is required to login in or sign up|
+| docs.suite.anct.gouv.fr    | ANCT    | French public agents working for the territorial administration and the extended public sphere. ProConnect is required to login in or sign up|
+| notes.liiib.re    | lasuite.coop    | Free and open demo to all. Content and acounts are reset after one month |
 
-⚠️ For some advanced features (ex: Export as PDF) Docs relies on XL packages from BlockNote. These are licenced under AGPL-3.0 and are not MIT compatible. You can perfectly use Docs without these packages by setting the environment variable `PUBLISH_AS_MIT` to true. That way you'll build an image of the application without the features that are not MIT compatible. Read the [environment variables documentation](/docs/env.md) for more information.
+
+
+#### ⚠️ Advanced features
+For some advanced features (ex: Export as PDF) Docs relies on XL packages from BlockNote. These are licenced under AGPL-3.0 and are not MIT compatible. You can perfectly use Docs without these packages by setting the environment variable `PUBLISH_AS_MIT` to true. That way you'll build an image of the application without the features that are not MIT compatible. Read the [environment variables documentation](/docs/env.md) for more information.
 
 ## Getting started 🔧
 

docs/installation/README.md

@@ -0,0 +1,32 @@
+# Installation
+If you want to install Docs you've come to the right place.
+Here are a bunch of resources to help you install the project.
+
+## Kubernetes
+We (Docs maintainers) are only using the Kubernetes deploymlent method in production. We can only provide advanced support for this method.
+Please follow the instructions laid out [here](/docs/installation/kubernetes.md).
+
+## Docker Compose
+We are aware that not everyone has Kubernetes Cluster laying around 😆. 
+We also provide [Docker images](https://hub.docker.com/u/lasuite?page=1&search=impress) that you can deploy using Compose. 
+Please follow the instructions [here](/docs/installation/compose.md). 
+⚠️ Please keep in mind that we do not use it ourselves in production. Let us know in the issues if you run into troubles, we'll try to help.
+
+## Other ways to install Docs
+Community members have contributed several other ways to install Docs. While we owe them a big thanks 🙏, please keep in mind we (Docs maintainers) can't provide support on these installation methods as we don't use them ourselves and there are two many options out there for us to keep track of. Of course you can contact the contributors and the broader community for assistance.
+
+Here is the list of other methods in alphabetical order:
+- Coop-Cloud: [code](https://git.coopcloud.tech/coop-cloud/lasuite-docs)
+- Nix: [Packages](https://search.nixos.org/packages?channel=unstable&query=lasuite-docs), ⚠️ unstable
+- Podman: [code][https://codeberg.org/philo/lasuite-docs-podman], ⚠️ experimental
+- YunoHost: [code](https://github.com/YunoHost-Apps/lasuite-docs_ynh), [app store](https://apps.yunohost.org/app/lasuite-docs)
+
+Feel free to make a PR to add ones that are not listed above 🙏
+
+## Cloud providers
+Some cloud providers are making it easy to deploy Docs on their infrastructure.
+
+Here is the list in alphabetical order:
+- Clever Cloud 🇫🇷 : [market place][https://www.clever-cloud.com/product/docs/], [technical doc](https://www.clever.cloud/developers/guides/docs/#deploy-docs)
+
+Feel free to make a PR to add ones that are not listed above 🙏