Move some documentation to docs/ and start overhaul

.gitlab-ci.yml

@@ -370,23 +370,17 @@ publish:package:
     - 'curl --header "JOB-TOKEN: $CI_JOB_TOKEN" --upload-file conduit-x86_64-unknown-linux-gnu.deb "${BASE_URL}/conduit-x86_64-unknown-linux-gnu.deb"'
 
 
-
 pages:
-  stage: publish
+  stage: "publish"
-  image: rust
+  image:
-  variables:
+    name: "squidfunk/mkdocs-material"
-    CARGO_HOME: $CI_PROJECT_DIR/cargo
+    entrypoint: [""]
-  before_script:
+  tags: ["docker"]
-    - export PATH="$PATH:$CARGO_HOME/bin"
+  needs: []
-    - mdbook --version || cargo install mdbook
-  script:
-    - mdbook build -d public
   rules:
     - if: '$CI_COMMIT_BRANCH == $CI_DEFAULT_BRANCH'
+  script:
+    - "mkdocs build --site-dir public"
   artifacts:
     paths:
-      - public
+      - "public"
-  cache:
-    key: mdbook_cache
-    paths:
-      - $CARGO_HOME/bin

mkdocs.yml

@@ -0,0 +1,20 @@
+site_name: Conduit Docs
+site_description: Conduit is a simple, fast and reliable chat server for the Matrix protocol
+theme:
+  name: material
+repo_url: https://gitlab.com/famedly/conduit
+nav:
+  - Home: index.md
+  - Installation:
+      - Prerequisites: installation/prerequisites.md
+      - Distribution Packages: installation/packages.md
+      - Manual: installation/manual.md
+      - Docker: installation/docker.md
+  - Configuration:
+      - Conduit.toml: configuration/conduit.toml.md
+      - Appservices: configuration/appservices.md
+  - Development:
+      - Basics: development/basics.md
+      - Cross compilation: development/cross-compilation.md
+      - Tests & CI: development/tests-ci.md
+