diff --git a/.gitlab-ci.yml b/.gitlab-ci.yml index 1602977b91dedf617f521b72fd8239e1dd31e2e3..7bf8eb7e47f8d690f4db4f12946f95eb96a7299e 100644 --- a/.gitlab-ci.yml +++ b/.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,39 @@ Documentation: paths: - documentation/design/documentation.pdf +.mdbook_common: &rust + before_script: + - cargo install mdbook + image: + name: rustdocker/rust:stable + stage: documentation + script: + - pwd + - ls + - mdbook build documentation --dest-dir public + cache: + paths: + - /root/.cargo/ + +documentation:static: + rules: + - if: '$CI_COMMIT_BRANCH == $CI_DEFAULT_BRANCH' + artifacts: + paths: + - 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 diff --git a/documentation/SUMMARY.md b/documentation/SUMMARY.md new file mode 100644 index 0000000000000000000000000000000000000000..b528cff5f125ce637633ddfc2de3d8179241c91e --- /dev/null +++ b/documentation/SUMMARY.md @@ -0,0 +1,7 @@ +# 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 diff --git a/documentation/book.toml b/documentation/book.toml new file mode 100644 index 0000000000000000000000000000000000000000..e59652fea44b560a604d19abe5faf38b06f2a612 --- /dev/null +++ b/documentation/book.toml @@ -0,0 +1,5 @@ +[book] +authors = [] +language = "en" +multilingual = false +src = "."