.gitlab-ci.yml

@@ -3,8 +3,7 @@ variables:
 
 stages:
   - test
-  - compliance
-  - build
+  - documentation
 
 before_script:
   - git config --global url."https://$GO_MODULES_USER:$GO_MODULES_ACCESS_TOKEN@code.fbi.h-da.de".insteadOf "https://code.fbi.h-da.de"
@@ -40,14 +39,14 @@ code-quality:
     paths:
       - gl-code-quality-report.json
 
-Documentation:
+documentation:pdf:
   before_script:
     - pwd
   image:
     name: pandoc/latex
     entrypoint:
     - ''
-  stage: build
+  stage: documentation
   rules:
     - changes:
       - documentation/design/*.md
@@ -59,18 +58,37 @@ Documentation:
     paths:
     - documentation/design/documentation.pdf
 
+.mdbook_common: &rust
+  before_script:
+      - cargo install mdbook
+  image:
+    name: rust:latest
+  stage: documentation
+  script:
+  - mdbook build documentation --dest-dir public
+  cache:
+    paths:
+    - /root/.cargo/
+
+documentation:static:
+  rules:
+    - if: '$CI_COMMIT_BRANCH == $CI_DEFAULT_BRANCH'
+  artifacts:
+    paths:
+      - documentation/public
+    expire_in: 1 week
+  <<: *rust
+
+documentation:test:
+  rules:
+    - if: '$CI_PIPELINE_SOURCE == "merge_request_event"'
+  <<: *rust
+
 sast:
   variables:
     SAST_ANALYZER_IMAGE_TAG: '2'
     SAST_EXCLUDED_PATHS: spec, test, tests, tmp
     SEARCH_MAX_DEPTH: '4'
-  stage: compliance
-
-license_scanning:
-  stage: compliance
-
-gemnasium-dependency_scanning:
-  stage: compliance
 
 include:
   - template: Security/SAST.gitlab-ci.yml

documentation/SUMMARY.md

+# goSDN Documentation
+
+- [Introduction](design/01-introduction.md)
+- [Related Work](design/02-related-work.md)
+- [Theoretical Background](design/03-theoretical-background.md)
+- [Conceptual Design](design/04-conceptual-design.md)
+- [Implementation](design/05-implementation.md)
\ No newline at end of file

documentation/book.toml

+[book]
+authors = ["Martin Stiemerling", "Manuel Kieweg", "Malte Bauch"]
+language = "en"
+multilingual = false
+src = "."
+
+[output.html]
+git-repository-url = "https://code.fbi.h-da.de/cocsn/gosdn"
+git-repository-icon = "fa-gitlab"
+site-url = "/public/"
\ No newline at end of file