From 50175548492444ce51aa06dc5ddb3a04bdfd94ff Mon Sep 17 00:00:00 2001
From: PAT0216 <prabuddha.tamhane@gmail.com>
Date: Thu, 29 Jan 2026 23:52:11 -0800
Subject: [PATCH] ci(docs): add Netlify deployment for PR previews

- Deploy to Netlify on PR and push to main
- Enable PR comment with preview URL
- Production deploy only on push to main
---
 .github/workflows/docs.yml | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml
index a0d886f..800941a 100644
--- a/.github/workflows/docs.yml
+++ b/.github/workflows/docs.yml
@@ -28,3 +28,16 @@ jobs:
       - name: Build documentation using Hatch
         run: |
             hatch run docs:build
+
+      - name: Deploy to Netlify
+        uses: nwtgck/actions-netlify@v3
+        with:
+          publish-dir: './docs'
+          production-deploy: ${{ github.event_name == 'push' && github.ref == 'refs/heads/main' }}
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+          deploy-message: "Deploy from GitHub Actions - ${{ github.event_name }}"
+          enable-pull-request-comment: true
+          enable-commit-comment: false
+        env:
+          NETLIFY_AUTH_TOKEN: ${{ secrets.NETLIFY_AUTH_TOKEN }}
+          NETLIFY_SITE_ID: ${{ secrets.NETLIFY_SITE_ID }}