docs(docs): resolve issue with shopping list docs (#744)

Author: agdimech

.github/workflows/release.yml

@@ -15,6 +15,7 @@ jobs:
       contents: write
     outputs:
       latest_commit: ${{ steps.git_remote.outputs.latest_commit }}
+      skip_release: ${{ steps.should_skip_release.outputs.skip_release }}
     env:
       CI: "true"
     steps:
@@ -41,6 +42,9 @@ jobs:
       - name: Check for new commits
         id: git_remote
         run: echo "latest_commit=$(git ls-remote origin -h ${{ github.ref }} | cut -f1)" >> $GITHUB_OUTPUT
+      - name: Should skip release
+        id: should_skip_release
+        run: echo "skip_release=$(git log --oneline -1 | grep -qE 'docs\(?.*\)?:|chore\(?.*\)?:|refactor\(?.*\)?:|test\(?.*\)?:' && echo true || echo false)" >> $GITHUB_OUTPUT
       - name: Extract Dists
         run: rsync -a . ./dist --include="*/" --include="/docs/dist/**" --include="/packages/pdk/dist/**" --exclude="*" --prune-empty-dirs
       - name: Upload artifact
@@ -55,7 +59,7 @@ jobs:
     runs-on: ubuntu-latest
     permissions:
       contents: write
-    if: needs.release.outputs.latest_commit == github.sha
+    if: needs.release.outputs.latest_commit == github.sha && needs.release.outputs.skip_release != 'true'
     steps:
       - uses: actions/setup-node@v2
         with:
@@ -77,8 +81,10 @@ jobs:
     needs: release
     runs-on: ubuntu-latest
     permissions:
+      id-token: write
+      issues: write
       contents: read
-    if: needs.release.outputs.latest_commit == github.sha
+    if: needs.release.outputs.latest_commit == github.sha && needs.release.outputs.skip_release != 'true'
     steps:
       - name: Install Node.js
         uses: actions/setup-node@v3
@@ -95,16 +101,32 @@ jobs:
         working-directory: dist/packages/pdk
         run: pnpm --package publib@latest dlx publib-npm
         env:
+          NPM_CONFIG_PROVENANCE: "true"  
           NPM_DIST_TAG: latest
           NPM_REGISTRY: registry.npmjs.org
           NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
+      - name: Extract Version
+        id: extract-version
+        working-directory: dist/packages/pdk
+        if: ${{ failure() }}
+        run: echo "VERSION=$(cat dist/releasetag.txt)" >> $GITHUB_OUTPUT
+      - name: Create Issue
+        if: ${{ failure() }}
+        uses: imjohnbo/issue-bot@v3
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        with:
+          labels: failed-release
+          title: Publishing v${{ steps.extract-version.outputs.VERSION }} to npm failed
+          body: See https://github.com/${{ github.repository }}/actions/runs/${{ github.run_id }}
   release_maven:
     name: Publish to Maven Central
     needs: release
     runs-on: ubuntu-latest
     permissions:
+      issues: write
       contents: read
-    if: needs.release.outputs.latest_commit == github.sha
+    if: needs.release.outputs.latest_commit == github.sha && needs.release.outputs.skip_release != 'true'
     steps:
       - uses: actions/setup-java@v2
         with:
@@ -131,13 +153,28 @@ jobs:
           MAVEN_PASSWORD: ${{ secrets.MAVEN_PASSWORD }}
           MAVEN_USERNAME: ${{ secrets.MAVEN_USERNAME }}
           MAVEN_STAGING_PROFILE_ID: ${{ secrets.MAVEN_STAGING_PROFILE_ID }}
+      - name: Extract Version
+        id: extract-version
+        working-directory: dist/packages/pdk
+        if: ${{ failure() }}
+        run: echo "VERSION=$(cat dist/releasetag.txt)" >> $GITHUB_OUTPUT
+      - name: Create Issue
+        if: ${{ failure() }}
+        uses: imjohnbo/issue-bot@v3
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        with:
+          labels: failed-release
+          title: Publishing v${{ steps.extract-version.outputs.VERSION }} to maven failed
+          body: See https://github.com/${{ github.repository }}/actions/runs/${{ github.run_id }}
   release_pypi:
     name: Publish to PyPI
     needs: release
     runs-on: ubuntu-latest
     permissions:
       contents: read
-    if: needs.release.outputs.latest_commit == github.sha
+      issues: write
+    if: needs.release.outputs.latest_commit == github.sha && needs.release.outputs.skip_release != 'true'
     steps:
       - name: Install Node.js
         uses: actions/setup-node@v3
@@ -159,6 +196,20 @@ jobs:
         env:
           TWINE_USERNAME: ${{ secrets.TWINE_USERNAME }}
           TWINE_PASSWORD: ${{ secrets.TWINE_PASSWORD }}
+      - name: Extract Version
+        id: extract-version
+        working-directory: dist/packages/pdk
+        if: ${{ failure() }}
+        run: echo "VERSION=$(cat dist/releasetag.txt)" >> $GITHUB_OUTPUT
+      - name: Create Issue
+        if: ${{ failure() }}
+        uses: imjohnbo/issue-bot@v3
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        with:
+          labels: failed-release
+          title: Publishing v${{ steps.extract-version.outputs.VERSION }} to pypi failed
+          body: See https://github.com/${{ github.repository }}/actions/runs/${{ github.run_id }}
   release_docs:
     needs: release_github
     runs-on: ubuntu-latest