Add mkdocs publishing of OSEP site

Author: reiterative

.github/workflows/main.yml

@@ -2,43 +2,39 @@ name: CI
 
 # Controls when the workflow will run
 on:
-  # Triggers the workflow on push or pull request events but only for the main branch
+  # Triggers the workflow on push events for the main branch
   push:
     branches: [ main ]
-  pull_request:
-    branches: [ main ]
+    branches: [ mkdocs ]
 
   # Allows you to run this workflow manually from the Actions tab
   workflow_dispatch:
 
+# Needs write permission to update the gh-pages branch that is used for GitHub Pages
+permissions:
+  contents: write
+
 # A workflow run is made up of one or more jobs that can run sequentially or in parallel
 jobs:
   # This workflow contains a single job called "build"
-  build:
-    # The type of runner that the job will run on
+  # Copied from https://squidfunk.github.io/mkdocs-material/publishing-your-site/
+  deploy:
     runs-on: ubuntu-latest
-
-    env:
-      STPATOOLS_VERSION: "42e07abc5510f5864aa102aa7ae1e8349911a620"
-      STPATOOLS_REPO: "https://gitlab.com/CodethinkLabs/stpatools.git"
-
-    # Steps represent a sequence of tasks that will be executed as part of the job
     steps:
-      # Checks-out your repository under $GITHUB_WORKSPACE, so your job can access it
-      - uses: actions/checkout@v2
-
-      # Check that YAML files are well-formed
-      - name: YAML lint
-        run: yamllint -d relaxed .
-
-      # Install specific version of ruamel.yaml required by STPAtools
-      - name: Install ruamel.yaml
-        run: pip3 install ruamel.yaml==0.16.7
-
-      # Install specific version of STPA tools from repo
-      - name: Install STPA tools
-        run: pip3 install "git+${{env.STPATOOLS_REPO}}@${{env.STPATOOLS_VERSION}}"
-
-      # Validate STPA files
-      - name: Validate STPA files (STPA_DynMA)
-        run: stpa-validate STPA_DynMA/*.yml
+      - uses: actions/checkout@v4
+      - name: Configure Git Credentials
+        run: |
+          git config user.name github-actions[bot]
+          git config user.email 41898282+github-actions[bot]@users.noreply.github.com
+      - uses: actions/setup-python@v5
+        with:
+          python-version: 3.x
+      - run: echo "cache_id=$(date --utc '+%V')" >> $GITHUB_ENV
+      - uses: actions/cache@v4
+        with:
+          key: mkdocs-material-${{ env.cache_id }}
+          path: .cache
+          restore-keys: |
+            mkdocs-material-
+      - run: pip install mkdocs-material
+      - run: mkdocs gh-deploy --force

docs/images/elisa-horizontal-color.svg

@@ -0,0 +1,6 @@
+# ELISA OSEP working group
+
+Welcome to the home of the Open Source Engineering Process (OSEP) working group.
+
+OSEP is one of the working groups of [Enabling Linux In Safety Applications
+(ELISA)](https://elisa.tech/), a Linux Foundation project.

docs/images/favicon.ico

@@ -0,0 +1,15 @@
+:root {
+
+    --md-text-font: "Open Sans";
+    --md-code-font: "FiraCode";
+
+    --elisa-green: #77c046;
+  }
+
+  [data-md-color-scheme="light-theme"] {
+    color-scheme: light;
+
+    --md-primary-fg-color: black;
+    --md-primary-bg-color: var(--elisa-green);
+
+  }