feat(docs): add dev site rendering to deploy workflow

.github/workflows/deploy.yml

@@ -5,11 +5,6 @@ on:
   release:
     types:
       - published
-  # workflow_run:
-  #   workflows:
-  #     - "Release and Publish VS Code Extension"
-  #   types:
-  #     - completed
 
 permissions:
   contents: read
@@ -35,18 +30,66 @@ jobs:
     steps:
       - name: Checkout repository
         uses: actions/checkout@v6
+        with:
+          fetch-depth: 0
 
       - name: Set up Quarto CLI
         uses: quarto-dev/quarto-actions/setup@v2
         with:
           version: pre-release
 
-      - name: Render Quarto Project
+      - name: Get latest tag
+        id: latest-tag
         shell: bash
-        working-directory: ./docs
         run: |
-          quarto render .
-          touch _site/.nojekyll
+          LATEST_TAG=$(git tag -l --sort=-v:refname '[0-9]*' | head -n 1)
+          if [ -z "${LATEST_TAG}" ]; then
+            echo "::error::No version tags found"
+            exit 1
+          fi
+          echo "tag=${LATEST_TAG}" >> "${GITHUB_OUTPUT}"
+          echo "Latest tag: ${LATEST_TAG}"
+
+      - name: Checkout latest tag
+        shell: bash
+        env:
+          LATEST_TAG: ${{ steps.latest-tag.outputs.tag }}
+        run: git checkout "${LATEST_TAG}"
+
+      - name: Render release site
+        shell: bash
+        working-directory: ./docs
+        run: quarto render .
+
+      - name: Checkout default branch
+        shell: bash
+        env:
+          DEFAULT_BRANCH: ${{ github.event.repository.default_branch }}
+        run: git checkout "${DEFAULT_BRANCH}"
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v6
+
+      - name: Install dependencies
+        shell: bash
+        run: npm ci
+
+      - name: Generate API docs
+        shell: bash
+        run: npm run docs:api
+
+      - name: Build dev VSIX
+        shell: bash
+        run: npx vsce package --pre-release --out docs/quarto-wizard-dev.vsix
+
+      - name: Render dev site
+        shell: bash
+        working-directory: ./docs
+        run: quarto render . --profile dev
+
+      - name: Prepare site for deployment
+        shell: bash
+        run: touch docs/_site/.nojekyll
 
       - name: Configure GitHub Pages
         uses: actions/configure-pages@v5

docs/_quarto-dev.yml

@@ -0,0 +1,14 @@
+project:
+  output-dir: _site/dev
+  resources:
+    - quarto-wizard-dev.vsix
+
+website:
+  title: "Quarto Wizard (Development)"
+  site-url: "https://m.canouil.dev/quarto-wizard/dev"
+  announcement:
+    icon: exclamation-circle
+    dismissable: false
+    content: "**Development** - This documentation is for the [development version of Quarto Wizard](quarto-wizard-dev.vsix). For the stable version, please visit [the main documentation](https://m.canouil.dev/quarto-wizard)."
+    type: warning
+    position: above-navbar