3 files changed, 48 insertions, 0 deletions
diff --git a/docs/guides/index.md b/docs/guides/index.md
new file mode 100644
index 00000000..25d4d949
--- /dev/null
+++ b/docs/guides/index.md
@@ -0,0 +1,3 @@
+## Guides
+
+In this section we try to provide you with some step-by-step guides for common scenarios to configure HedgeDoc to your needs.
diff --git a/docs/index.md b/docs/index.md
new file mode 100644
index 00000000..e00a1d10
--- /dev/null
+++ b/docs/index.md
@@ -0,0 +1,7 @@
+# Welcome to the HedgeDoc Documentation
+
+This page should help you host and configure your own HedgeDoc instance.
+
+We provide: 
+- [Guides for common scenarios](guides/index.md)
+ 
diff --git a/mkdocs.yml b/mkdocs.yml
new file mode 100644
index 00000000..dfe74d43
--- /dev/null
+++ b/mkdocs.yml
@@ -0,0 +1,38 @@
+site_name: HedgeDoc
+site_url: https://docs.hedgedoc.org
+nav:
+  - Home: index.md
+  - Setup:
+      - 'Manual Installation': setup/manual-setup.md
+      - 'Reverse Proxy': setup/reverse-proxy.md
+      - Docker: setup/docker.md
+      - Kubernetes: setup/kubernetes.md
+      - Cloudron: setup/cloudron.md
+      - Heroku: setup/heroku.md
+      - LinuxServer: setup/docker-linuxserver.md
+      - Yunohost: setup/yunohost.md
+  - Guides:
+      - Authentication:
+          - LDAP: guides/auth/ldap-ad.md
+          - OAuth: guides/auth/oauth.md
+          - SAML : guides/auth/saml.md
+          - SAML Keycloak : guides/auth/saml-keycloak.md
+          - SAML Onelogin : guides/auth/saml-onelogin.md
+          - GitHub: guides/auth/github.md
+          - GitLab: guides/auth/gitlab-self-hosted.md
+          - Keycloak: guides/auth/keycloak.md
+          - NextCloud: guides/auth/nextcloud.md
+          - Twitter: guides/auth/twitter.md
+      - Migrate from Etherpad: guides/migrate-etherpad.md
+      - Breaking Changes: guides/migrations-and-breaking-changes.md
+      - Media Backend:
+          - Minion: guides/minio-image-upload.md
+          - S3: guides/s3-image-upload.md
+      - Setting Terms: guides/providing-terms.md
+  - Configuration: configuration.md
+  - Developer:
+      - API: dev/api.md
+      - 'Developer Notes': dev/getting-started.md
+      - 'Operational Transformation': dev/ot.md
+      - Webpack: dev/webpack.md
+theme: readthedocs