Automatic generation and prep of docs to be deployed with github pages

.github/workflows/documentation.yml

@@ -0,0 +1,56 @@
+name: Documentation CI
+
+on:
+  push:
+    branches: [ "main" ]
+
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+
+  documentation:
+    name: Update documentation
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v3
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+          ref: ${{ github.head_ref }}
+      - name: Set up Elixir
+        uses: erlef/setup-beam@61e01a43a562a89bfc54c7f9a378ff67b03e4a21 # v1.16.0
+        with:
+          elixir-version: '1.15.2' # [Required] Define the Elixir version
+          otp-version: '26.0'      # [Required] Define the Erlang/OTP version
+
+      - name: Restore dependencies cache
+        uses: actions/cache@v3
+        with:
+          path: deps
+          key: ${{ runner.os }}-mix-${{ hashFiles('**/mix.lock') }}
+          restore-keys: ${{ runner.os }}-mix-
+
+      - name: Install dependencies
+        run: mix deps.get
+
+      - name: Generate Documentation
+        run: mix docs
+
+      - name: Include docs folder
+        run: |
+          sed -i '/\/docs\//d' .gitignore
+
+      - name: Commit changes to documentation branch
+        env:
+          ATTR_NAME: 'github-actions[bot]'
+          ATTR_EMAIL: 'github-actions[bot]@users.noreply.github.com'
+        run: |
+          git config --global user.name $ATTR_NAME
+          git config --global user.email $ATTR_EMAIL
+          git add docs/*
+          git commit -am "Automatic docs generation"
+          git fetch origin docs
+          git push origin main:docs --force-with-lease

.github/workflows/elixir.yml

@@ -6,17 +6,16 @@
 name: Elixir CI
 
 on:
-  push:
-    branches: [ "main" ]
   pull_request:
     branches: [ "main" ]
 
-permissions:
-  contents: read
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
 
 jobs:
   build:
-
     name: Build and test
     runs-on: ubuntu-latest
 
@@ -37,3 +36,4 @@ jobs:
       run: mix deps.get
     - name: Run tests
       run: mix test
+