updated

Author: PavanMudigonda

.github/workflows/deploy-netlify.yml

@@ -0,0 +1,61 @@
+name: Deploy MkDocs to Netlify
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+    branches:
+      - main
+  workflow_dispatch:
+
+jobs:
+  build-and-deploy:
+    runs-on: ubuntu-latest
+    
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v6
+        with:
+          fetch-depth: 0
+
+      - name: Setup Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: 'latest'
+          cache: pip
+          cache-dependency-path: requirements-docs.txt
+
+      - name: Install dependencies
+        run: pip install -r requirements-docs.txt
+
+      - name: Generate MkDocs site
+        run: |
+          bash scripts/build_site.sh
+          mkdocs build
+        env:
+          GOOGLE_ANALYTICS_ID: ${{ secrets.GOOGLE_ANALYTICS_ID }}
+
+      - name: Setup Node.js (for Netlify CLI)
+        uses: actions/setup-node@v6
+        with:
+          node-version: lts/*
+
+      - name: Install Netlify CLI
+        run: npm install -g netlify-cli
+
+      # Deploy preview for Pull Requests
+      - name: Deploy preview to Netlify
+        if: github.event_name == 'pull_request'
+        run: netlify deploy --dir=site --message="PR ${{ github.event.number }} - Run ${{ github.run_number }}"
+        env:
+          NETLIFY_AUTH_TOKEN: ${{ secrets.NETLIFY_AUTH_TOKEN }}
+          NETLIFY_SITE_ID: ${{ secrets.NETLIFY_SITE_ID }}
+
+      # Deploy to Production for Main branch pushes
+      - name: Deploy to Netlify Production
+        if: github.event_name == 'push' && github.ref == 'refs/heads/main'
+        run: netlify deploy --prod --dir=site --message="Deploy Main - Run ${{ github.run_number }}"
+        env:
+          NETLIFY_AUTH_TOKEN: ${{ secrets.NETLIFY_AUTH_TOKEN }}
+          NETLIFY_SITE_ID: ${{ secrets.NETLIFY_SITE_ID }}

docs/index.md

@@ -0,0 +1,5 @@
+# Python Bro Code Documentation
+
+Welcome to the Python Bro Code documentation site.
+
+This site uses [MkDocs](https://mkdocs.org) and the [Material for MkDocs](https://squidfunk.github.io/mkdocs-material/) theme to serve documentation.

mkdocs.yml

@@ -0,0 +1,12 @@
+site_name: Python Bro Code Docs
+site_author: Pavan Mudigonda
+site_description: Documentation for Python Bro Code examples.
+
+repo_name: pavanmudigonda/python-bro-code
+repo_url: https://github.com/pavanmudigonda/python-bro-code
+
+theme:
+  name: material
+
+nav:
+  - Home: index.md

netlify.toml

@@ -0,0 +1,3 @@
+[build]
+  command = "pip install -r requirements-docs.txt && bash scripts/build_site.sh && mkdocs build"
+  publish = "site"

requirements-docs.txt

@@ -0,0 +1,2 @@
+mkdocs>=1.4.2
+mkdocs-material>=9.0.0

scripts/build_site.sh

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+
+# This script runs any pre-build steps before mkdocs build
+echo "Running pre-build steps for MkDocs..."
+
+# Example: Auto-generate docs from source if needed
+# (Currently just a placeholder to satisfy the GitHub Action)
+exit 0