From 0b961036b7dc756632fc97676eb71aea3f682ca6 Mon Sep 17 00:00:00 2001
From: Benoit Chesneau <bchesneau@gmail.com>
Date: Thu, 22 Jan 2026 22:30:37 +0100
Subject: [PATCH] docs: Configure GitHub Pages deployment with custom domain

---
 .github/workflows/docs.yml | 14 +++++++++++---
 docs/content/404.md        | 22 ++++++++++++++++++++++
 2 files changed, 33 insertions(+), 3 deletions(-)
 create mode 100644 docs/content/404.md

diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml
index 65098c18..0f6aef18 100644
--- a/.github/workflows/docs.yml
+++ b/.github/workflows/docs.yml
@@ -2,18 +2,23 @@ name: Docs
 
 on:
   push:
-    branches: [ main ]
+    branches: [ master ]
     paths:
       - 'docs/**'
       - 'mkdocs.yml'
+      - 'scripts/build_settings_doc.py'
+      - 'gunicorn/config.py'
       - 'requirements_dev.txt'
       - '.github/workflows/docs.yml'
   pull_request:
     paths:
       - 'docs/**'
       - 'mkdocs.yml'
+      - 'scripts/build_settings_doc.py'
+      - 'gunicorn/config.py'
       - 'requirements_dev.txt'
       - '.github/workflows/docs.yml'
+  workflow_dispatch:
 
 jobs:
   build:
@@ -29,6 +34,7 @@ jobs:
       - name: Install dependencies
         run: |
           python -m pip install --upgrade pip
+          pip install -e .
           pip install -r requirements_dev.txt
 
       - name: Build documentation
@@ -42,7 +48,7 @@ jobs:
           retention-days: 7
 
   deploy:
-    if: github.event_name == 'push' && github.ref == 'refs/heads/main'
+    if: github.event_name == 'push' && github.ref == 'refs/heads/master'
     needs: build
     runs-on: ubuntu-latest
     permissions:
@@ -58,6 +64,7 @@ jobs:
       - name: Install dependencies
         run: |
           python -m pip install --upgrade pip
+          pip install -e .
           pip install -r requirements_dev.txt
 
       - name: Build documentation
@@ -69,4 +76,5 @@ jobs:
           github_token: ${{ secrets.GITHUB_TOKEN }}
           publish_dir: site
           publish_branch: gh-pages
-          commit_message: "docs: deploy {sha}"
+          cname: gunicorn.org
+          commit_message: "docs: deploy ${{ github.sha }}"
diff --git a/docs/content/404.md b/docs/content/404.md
new file mode 100644
index 00000000..211fcad0
--- /dev/null
+++ b/docs/content/404.md
@@ -0,0 +1,22 @@
+# Page Not Found
+
+The page you're looking for doesn't exist or has moved.
+
+<div class="quick-links" style="margin-top: 2rem;">
+  <a href="/" class="quick-link">
+    <strong>Home</strong>
+    <span>Return to the homepage</span>
+  </a>
+  <a href="/quickstart/" class="quick-link">
+    <strong>Quickstart</strong>
+    <span>Get started with Gunicorn</span>
+  </a>
+  <a href="/reference/settings/" class="quick-link">
+    <strong>Settings</strong>
+    <span>Configuration reference</span>
+  </a>
+  <a href="https://github.com/benoitc/gunicorn/issues" class="quick-link">
+    <strong>Report Issue</strong>
+    <span>Let us know about broken links</span>
+  </a>
+</div>