fix: Fixing Pages Build (#3260)

* fix: Trying to get pages builds working

* fix: Explicit baseurl

* fix: Explicitly navigate to docs directory before building

* fix: Navigating to `docs` directory before setting up ruby

* fix: Downgrade Ruby version

* fix: Bumping up Gemfile.lock

* fix: Adding release back

* fix: Adding excludes to pages build

* fix: Remove deploy again to verify a few other things

* fix: Adjusting build and adding deploy in

.github/workflows/pages.yml

@@ -1,15 +1,9 @@
-# This workflow uses actions that are not certified by GitHub.
-# They are provided by a third-party and are governed by
-# separate terms of service, privacy policy, and support
-# documentation.
-
-# Sample workflow for building and deploying a Jekyll site to GitHub Pages
-name: Deploy Jekyll site to Pages
+name: Deploy Docs site to Pages
 
 on:
   # Runs on pushes targeting the default branch
   push:
-    branches: [$default-branch]
+    branches: [master]
 
   # Allows you to run this workflow manually from the Actions tab
   workflow_dispatch:
@@ -36,31 +30,33 @@ jobs:
       - name: Setup Ruby
         uses: ruby/setup-ruby@8575951200e472d5f2d95c625da0c7bec8217c42 # v1.161.0
         with:
-          ruby-version: '3.1' # Not needed with a .ruby-version file
-          bundler-cache: true # runs 'bundle install' and caches installed gems automatically
+          ruby-version: '3.3'
+          bundler-cache: true
           cache-version: 0 # Increment this number if you need to re-download cached gems
+          working-directory: docs
       - name: Setup Pages
         id: pages
         uses: actions/configure-pages@v5
       - name: Build with Jekyll
-        # Outputs to the './_site' directory by default
-        run: bundle exec jekyll build --baseurl "${{ steps.pages.outputs.base_path }}"
+        working-directory: docs
+        run: bundle exec jekyll build
         env:
           JEKYLL_ENV: production
       - name: Upload artifact
-        # Automatically uploads an artifact from the './_site' directory by default
         uses: actions/upload-pages-artifact@v3
+        with:
+          path: docs/_site
 
-  # Not deploying yet, as we're not sure this will build right.
+  # We're not deploying yet, as we're making sure the build is successful first
 
   # Deployment job
-  #   deploy:
-  #     environment:
-  #       name: github-pages
-  #       url: ${{ steps.deployment.outputs.page_url }}
-  #     runs-on: ubuntu-latest
-  #     needs: build
-  #     steps:
-  #       - name: Deploy to GitHub Pages
-  #         id: deployment
-  #         uses: actions/deploy-pages@v4
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    needs: build
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

docs/.tool-versions

@@ -0,0 +1,2 @@
+ruby 3.3.4
+