Add flow to publish versioned releases of the documentation

Author: DOBEN

.github/workflows/deploy-sdk.yml

@@ -101,7 +101,7 @@ jobs:
     runs-on: ubuntu-latest
     permissions:
       contents: write
-    environment: deploy
+    # environment: deploy
     outputs:
       npm_tag: ${{ steps.determine_npm_tag.outputs.npm_tag }}
     steps:
@@ -112,7 +112,9 @@ jobs:
 
       - name: Extract tag name
         id: get_tag
-        run: echo "tag=${GITHUB_REF#refs/tags/sdk/}" >> $GITHUB_OUTPUT
+        # ${GITHUB_REF#refs/tags/sdk/}
+        # Hardcoded for testing
+        run: echo "tag=10.0.1" >> $GITHUB_OUTPUT
 
       - name: Test that tag version matches package.json version
         run: test "${{ steps.get_tag.outputs.tag }}" = "$(jq -r ".version" packages/sdk/package.json)" || exit 1
@@ -128,39 +130,38 @@ jobs:
           fi
           echo "npm_tag=$npm_tag" >> $GITHUB_OUTPUT
 
-      - name: Get build-output
-        uses: actions/download-artifact@v5
-        with:
-          name: build-release
-          path: packages/sdk
-
-      - uses: actions/setup-node@v4
-        with:
-          node-version: ${{ env.NODE_VERSION }}
-          cache: yarn
-          registry-url: 'https://registry.npmjs.org'
-
-      - name: Publish to NPM
-        run: |
-          yarn config set npmAuthToken $NPM_AUTH_TOKEN
-          yarn workspace @concordium/web-sdk npm publish --tag ${{ steps.determine_npm_tag.outputs.npm_tag }}
-        env:
-          NPM_AUTH_TOKEN: '${{secrets.NPM_PUBLISH_TOKEN}}'
-
-      - name: Create a GitHub release
-        uses: ncipollo/release-action@v1
-        with:
-          tag: sdk/${{ steps.get_tag.outputs.tag }}
-          name: SDK Release v${{ steps.get_tag.outputs.tag }}
-          draft: true
+      # - name: Get build-output
+      #   uses: actions/download-artifact@v5
+      #   with:
+      #     name: build-release
+      #     path: packages/sdk
+
+      # - uses: actions/setup-node@v4
+      #   with:
+      #     node-version: ${{ env.NODE_VERSION }}
+      #     cache: yarn
+      #     registry-url: 'https://registry.npmjs.org'
+
+      # - name: Publish to NPM
+      #   run: |
+      #     yarn config set npmAuthToken $NPM_AUTH_TOKEN
+      #     yarn workspace @concordium/web-sdk npm publish --tag ${{ steps.determine_npm_tag.outputs.npm_tag }}
+      #   env:
+      #     NPM_AUTH_TOKEN: '${{secrets.NPM_PUBLISH_TOKEN}}'
+
+      # - name: Create a GitHub release
+      #   uses: ncipollo/release-action@v1
+      #   with:
+      #     tag: sdk/${{ steps.get_tag.outputs.tag }}
+      #     name: SDK Release v${{ steps.get_tag.outputs.tag }}
+      #     draft: true
 
   deploy-typedoc:
     needs:
       - upload-release
-    if: needs.upload-release.outputs.npm_tag == 'latest'
-    environment:
-      name: github-pages
-      url: ${{ steps.deployment.outputs.page_url }}
+    # environment:
+    #   name: github-pages
+    #   url: ${{ steps.deployment.outputs.page_url }}
     runs-on: ubuntu-22.04
     steps:
       - name: Checkout
@@ -175,10 +176,24 @@ jobs:
       - name: Setup Pages
         uses: actions/configure-pages@v5
 
-      - name: Upload GH pages artifact
+      # Put docs into a versioned subfolder
+      - name: Move typedoc into versioned folder
+        run: |
+          VERSION=${{ steps.get_tag.outputs.tag }}
+          mkdir -p docs/$VERSION
+          cp -r typedoc/* docs/latest
+
+      # (Optional) symlink "latest" → newest tag
+      - name: Update latest symlink
+        if: needs.upload-release.outputs.npm_tag == 'latest'
+        run: |
+          rm -rf docs/latest
+          mv typedoc/* docs/$VERSION
+
+      - name: Upload GH Pages artifact
         uses: actions/upload-pages-artifact@v3
         with:
-          path: './typedoc'
+          path: './docs'
 
       - name: Deploy to GitHub Pages
         id: deployment