sync changes between docs publishing Action and main PR Action

Author: sujaypatil96

.github/workflows/build-publish-documentation.yaml

@@ -7,13 +7,11 @@ on:
       - main
 
 jobs:
-  build-docs:
+  github-pages:
     runs-on: ubuntu-latest
     strategy:
       matrix:
         python-version: [ "3.9" ]
-  github-pages:
-    runs-on: ubuntu-latest
 
     permissions:
       contents: write

.github/workflows/main.yaml

@@ -23,38 +23,30 @@ jobs:
       #       check-out repo and set-up python
       #----------------------------------------------
       - name: Check out repository
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4.2.2
+        with:
+          fetch-depth: 0
 
       - name: Set up Python ${{ matrix.python-version }}
-        uses: actions/setup-python@v4
+        uses: actions/setup-python@v5.6.0
+        id: setup-python
         with:
           python-version: ${{ matrix.python-version }}
+          cache: 'poetry'
 
       #----------------------------------------------
-      #          install & configure poetry
+      #               install poetry
       #----------------------------------------------
       - name: Install Poetry
-        uses: snok/install-poetry@v1.3
-        with:
-          virtualenvs-create: true
-          virtualenvs-in-project: true
-
-      #----------------------------------------------
-      #       load cached venv if cache exists      
-      #----------------------------------------------
-      - name: Load cached venv
-        id: cached-poetry-dependencies
-        uses: actions/cache@v3
-        with:
-          path: .venv
-          key: venv-${{ runner.os }}-${{ hashFiles('**/poetry.lock') }}
+        run: |
+          pipx install poetry
+          pipx inject poetry poetry-dynamic-versioning
 
       #----------------------------------------------
-      # install dependencies if cache does not exist 
+      #           install dependencies 
       #----------------------------------------------
       - name: Install dependencies
-        if: steps.cached-poetry-dependencies.outputs.cache-hit != 'true'
-        run: poetry install --no-interaction --no-root
+        run: poetry install --no-interaction --no-root --with docs --all-extras
 
       #----------------------------------------------
       #              run test suite