Test doc-build action

.github/workflows/github_action_build_docs.yml

@@ -0,0 +1,45 @@
+# This github-Evennia workflow will build the docs.
+
+name: documentation
+
+on:
+  push:
+    branches: [ master, develop ]
+    paths:
+      - 'docs/source/**'
+  pull_request:
+    branches: [ master, develop ]
+    paths:
+      - 'docs/source/**'
+
+jobs: 
+  build:
+    runs-on: ubuntu-latest
+
+    strategy:
+      matrix:
+        python-version: [3.7]
+        TESTING_DB: ['sqlite3']
+
+    steps:
+      - uses: actions/checkout@v2 
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v2
+        with:
+          python-version: ${{ matrix.python-version }}
+       
+      - name: Install package dependencies
+        run: |
+          python -m pip install --upgrade pip
+          cd docs/
+          make install
+
+      - name: Quick-test docs (no autodocs)
+        run: |
+          make quick 
+
+      - name: Deploy docs (only from master/develop branch)
+        if: ${{ github.ref == 'refs/heads/develop' || github.ref == 'refs/heads/master'}}
+        run: |
+          echo "Would deploy here!"

.github/workflows/github_action_test_suite.yml

@@ -6,6 +6,8 @@ name: test-suite
 on:
   push:
     branches: [ master, develop ]
+    paths-ignore:
+      - 'docs/source/**'
   pull_request:
     branches: [ master, develop ]
 
@@ -105,31 +107,3 @@ jobs:
       with:
         project-token: ${{ secrets.CODACY_PROJECT_TOKEN }}
         coverage-reports: ./testing_mygame/coverage.xml
-
-  one:
-    runs-on: ubuntu-latest
-    steps:
-      - name: Dump GitHub context
-        env:
-          GITHUB_CONTEXT: ${{ toJson(github) }}
-        run: echo "$GITHUB_CONTEXT"
-      - name: Dump job context
-        env:
-          JOB_CONTEXT: ${{ toJson(job) }}
-        run: echo "$JOB_CONTEXT"
-      - name: Dump steps context
-        env:
-          STEPS_CONTEXT: ${{ toJson(steps) }}
-        run: echo "$STEPS_CONTEXT"
-      - name: Dump runner context
-        env:
-          RUNNER_CONTEXT: ${{ toJson(runner) }}
-        run: echo "$RUNNER_CONTEXT"
-      - name: Dump strategy context
-        env:
-          STRATEGY_CONTEXT: ${{ toJson(strategy) }}
-        run: echo "$STRATEGY_CONTEXT"
-      - name: Dump matrix context
-        env:
-          MATRIX_CONTEXT: ${{ toJson(matrix) }}
-        run: echo "$MATRIX_CONTEXT"

docs/Makefile

@@ -56,7 +56,7 @@ _multiversion-check-env:
 _clean_api_index:
 	rm source/api/*
 
-# remove supervluous 'module' and 'package' text from api headers
+# remove superfluos 'module' and 'package' text from api headers
 _reformat_apidoc_headers:
 	for f in source/api/*.rst; do\
         perl -pi -e 's/(module|package)$$// if $$. == 1' $$f ;\