👷 update GitHub Actions workflows for improved structure and efficiency

Author: techouse

.github/workflows/publish.yml

@@ -21,28 +21,22 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
-        
       - name: Get name, version, and group from csproj files
         id: get_version
         run: |
           set -e
           VERSION=$(awk -F'[<>]' '/^[[:space:]]*<Version>/ {print $3}' QsNet/QsNet.csproj)
           echo "VERSION=$VERSION" >> $GITHUB_ENV
-
       - name: Setup .NET
         uses: actions/setup-dotnet@v4
         with:
           dotnet-version: '8.0.x'
-
       - name: Restore
         run: dotnet restore
-
       - name: Build & Pack
         run: dotnet pack QsNet/QsNet.csproj -c Release -o ./artifacts
-        
       - name: Push to NuGet
         run: dotnet nuget push ./artifacts/QsNet.$VERSION.nupkg --api-key ${{ secrets.NUGET_API_KEY }} --source https://api.nuget.org/v3/index.json --skip-duplicate
-
       - name: Upload .nupkg artefact
         uses: actions/upload-artifact@v4
         with:
@@ -91,4 +85,12 @@ jobs:
         if: ${{ always() }}
         run: |
           rm -rf $CHANGELOG_PATH
-          rm -rf ./artifacts/*.nupkg
+          rm -rf ./artifacts/*.nupkg
+  docs:
+    uses: ./.github/workflows/docs.yml
+    secrets: inherit
+    needs:
+      - test
+      - publish
+    permissions:
+      contents: write

.github/workflows/test.yml

@@ -25,47 +25,39 @@ jobs:
 
     steps:
       - uses: actions/checkout@v4
-
       - name: Setup .NET 8 SDK
         uses: actions/setup-dotnet@v4
         with:
           dotnet-version: '8.0.x'
-
       - name: Cache NuGet
         uses: actions/cache@v4
         with:
           path: ~/.nuget/packages
           key: nuget-${{ runner.os }}-${{ hashFiles('**/*.[cC][sS]proj', '**/*.props', '**/*.targets') }}
           restore-keys: nuget-${{ runner.os }}-
-
       - name: Restore
         run: dotnet restore
-
       - name: dotnet format (verify)
         run: dotnet format --verify-no-changes --verbosity minimal
-
       - name: Build (warnings -> errors)
         run: dotnet build --configuration Release -p:TreatWarningsAsErrors=true --no-restore
-  
   test:
     name: Test ${{ matrix.dotnet }} on ${{ matrix.os }}
     needs: lint
     runs-on: ${{ matrix.os }}
-
     strategy:
       fail-fast: false
       matrix:
         os: [ ubuntu-latest ]
-        dotnet: [ '8.0.x', '9.0.x' ]
-
+        dotnet: 
+          - '8.0.x'
+          - '9.0.x'
     steps:
       - uses: actions/checkout@v4
-
       - name: Setup .NET SDK
         uses: actions/setup-dotnet@v4
         with:
           dotnet-version: ${{ matrix.dotnet }}
-
       - name: Cache NuGet
         uses: actions/cache@v4
         with:
@@ -74,20 +66,12 @@ jobs:
           restore-keys: |
             nuget-${{ runner.os }}-${{ matrix.dotnet }}-
             nuget-${{ runner.os }}-
-
       - name: Restore
         run: dotnet restore
-
       - name: Build
         run: dotnet build --configuration Release --no-restore
-
       - name: Test + Coverage
-        run: |
-          dotnet test --configuration Release --no-build \
-            --verbosity normal \
-            --logger "trx;LogFileName=test-results.trx" \
-            --collect "XPlat Code Coverage"
-
+        run: dotnet test --configuration Release --no-build --verbosity normal --logger "trx;LogFileName=test-results.trx" --collect "XPlat Code Coverage"
       - name: Upload TRX
         uses: actions/upload-artifact@v4
         if: always()
@@ -96,7 +80,6 @@ jobs:
           path: '**/*.trx'
           overwrite: true
           retention-days: 7
-
       - name: Upload raw coverage
         uses: actions/upload-artifact@v4
         with:
@@ -105,43 +88,26 @@ jobs:
           if-no-files-found: error
           overwrite: true
           retention-days: 7
-  
   coverage:
     name: Coverage (merged)
     runs-on: ubuntu-latest
     needs: test
-
     steps:
       - uses: actions/checkout@v4
-
       - name: Setup .NET 8 SDK
         uses: actions/setup-dotnet@v4
         with:
           dotnet-version: '8.0.x'
-
       - name: Restore
         run: dotnet restore
-
       - name: Build
         run: dotnet build --configuration Release --no-restore
-
       - name: Test w/ coverage (8.0—single run)
-        run: |
-          dotnet test --configuration Release --no-build \
-            --collect "XPlat Code Coverage" \
-            --results-directory coverage \
-            --settings coverlet.runsettings
-
+        run: dotnet test --configuration Release --no-build --collect "XPlat Code Coverage" --results-directory coverage --settings coverlet.runsettings
       - name: Install ReportGenerator
         run: dotnet tool install -g dotnet-reportgenerator-globaltool
-
       - name: Generate consolidated report
-        run: |
-          reportgenerator \
-            -reports:"**/coverage.cobertura.xml" \
-            -targetdir:"coverage/report" \
-            -reporttypes:"Html;Cobertura;JsonSummary"
-
+        run: reportgenerator -reports:"**/coverage.cobertura.xml" -targetdir:"coverage/report" -reporttypes:"Html;Cobertura;JsonSummary"
       - name: Upload to Codecov
         uses: codecov/codecov-action@v5
         env:
@@ -151,7 +117,6 @@ jobs:
           flags: unittests
           name: codecov-umbrella
           fail_ci_if_error: false
-
       - name: Upload coverage report artifact
         uses: actions/upload-artifact@v4
         with: