From b73a3427534f0e291938df2a6ad0cb74c861917a Mon Sep 17 00:00:00 2001
From: Danny Colin <contact@dannycolin.com>
Date: Wed, 14 Jan 2026 17:35:44 -0500
Subject: [PATCH] Fix missing documentation for version 4 and lower

* Pull documentation submodule before the build step
* Fix urls in docs.html
---
 .github/workflows/jekyll.yml |  3 ++
 docs.html                    | 80 ++++++++++++++++++------------------
 2 files changed, 43 insertions(+), 40 deletions(-)

diff --git a/.github/workflows/jekyll.yml b/.github/workflows/jekyll.yml
index 558794f..16be91e 100644
--- a/.github/workflows/jekyll.yml
+++ b/.github/workflows/jekyll.yml
@@ -40,6 +40,9 @@ jobs:
           ruby-version: '3.2' # Not needed with a .ruby-version file
           bundler-cache: true # runs 'bundle install' and caches installed gems automatically
           cache-version: 1 # Increment this number if you need to re-download cached gems
+          # Pull the /docs folder
+          submodules: recursive
+          fetch-depth: 0
       - name: Setup Pages
         id: pages
         uses: actions/configure-pages@v5
diff --git a/docs.html b/docs.html
index 16a54ec..bdb2ead 100644
--- a/docs.html
+++ b/docs.html
@@ -46,12 +46,12 @@
   <tr><td><b>Bugzilla 4.4.14</b></td>
       <td><i>(deprecated old stable)<br>(end-of-life 2025/01/03)</i></td>
       <td>
-        <a href="{{ "4.4/en/html/" | absolute_url }}">[Online HTML]</a>
-        <a href="{{ "4.4/en/pdf/Bugzilla-Guide.pdf" | absolute_url }}">[PDF]</a>
-        <a href="{{ "4.4/en/txt/Bugzilla-Guide.txt" | absolute_url }}">[Text]</a>
+        <a href="{{ "docs/4.4/en/html/" | absolute_url }}">[Online HTML]</a>
+        <a href="{{ "docs/4.4/en/pdf/Bugzilla-Guide.pdf" | absolute_url }}">[PDF]</a>
+        <a href="{{ "docs/4.4/en/txt/Bugzilla-Guide.txt" | absolute_url }}">[Text]</a>
       </td>
       <td>
-        <a href="{{ "4.4/en/html/api/" | absolute_url }}">[APIs, including XML-RPC and JSON-RPC]</a>
+        <a href="{{ "docs/4.4/en/html/api/" | absolute_url }}">[APIs, including XML-RPC and JSON-RPC]</a>
       </td>
   </tr>
 
@@ -62,102 +62,102 @@
   <tr><td>Bugzilla 4.2.16</td>
       <td></td>
       <td>
-        <a href="{{ "4.2/en/html/" | absolute_url }}">[Online HTML]</a>
-      <a href="{{ "4.2/en/pdf/Bugzilla-Guide.pdf" | absolute_url }}">[PDF]</a>
-      <a href="{{ "4.2/en/txt/Bugzilla-Guide.txt" | absolute_url }}">[Text]</a>
+        <a href="{{ "docs/4.2/en/html/" | absolute_url }}">[Online HTML]</a>
+        <a href="{{ "docs/4.2/en/pdf/Bugzilla-Guide.pdf" | absolute_url }}">[PDF]</a>
+        <a href="{{ "docs/4.2/en/txt/Bugzilla-Guide.txt" | absolute_url }}">[Text]</a>
       </td>
       <td>
-      <a href="{{ "4.2/en/html/api/" | absolute_url }}">[APIs, including XML-RPC and JSON-RPC]</a>
+      <a href="{{ "docs/4.2/en/html/api/" | absolute_url }}">[APIs, including XML-RPC and JSON-RPC]</a>
       </td>
   </tr>
   <tr><td>Bugzilla 4.0.18</td>
       <td></td>
       <td>
-      <a href="{{ "4.0/en/html/" | absolute_url }}">[Online HTML]</a>
-      <a href="{{ "4.0/en/pdf/Bugzilla-Guide.pdf" | absolute_url }}">[PDF]</a>
-      <a href="{{ "4.0/en/txt/Bugzilla-Guide.txt" | absolute_url }}">[Text]</a>
+      <a href="{{ "docs/4.0/en/html/" | absolute_url }}">[Online HTML]</a>
+      <a href="{{ "docs/4.0/en/pdf/Bugzilla-Guide.pdf" | absolute_url }}">[PDF]</a>
+      <a href="{{ "docs/4.0/en/txt/Bugzilla-Guide.txt" | absolute_url }}">[Text]</a>
       </td>
       <td>
-      <a href="{{ "4.0/en/html/api/" | absolute_url }}">[APIs, including XML-RPC and JSON-RPC]</a>
+      <a href="{{ "docs/4.0/en/html/api/" | absolute_url }}">[APIs, including XML-RPC and JSON-RPC]</a>
       </td>
   </tr>
   <tr><td>Bugzilla 3.6.13</td>
       <td></td>
       <td>
-      <a href="{{ "3.6/en/html/" | absolute_url }}">[Online HTML]</a>
-      <a href="{{ "3.6/en/pdf/Bugzilla-Guide.pdf" | absolute_url }}">[PDF]</a>
-      <a href="{{ "3.6/en/txt/Bugzilla-Guide.txt" | absolute_url }}">[Text]</a>
+      <a href="{{ "docs/3.6/en/html/" | absolute_url }}">[Online HTML]</a>
+      <a href="{{ "docs/3.6/en/pdf/Bugzilla-Guide.pdf" | absolute_url }}">[PDF]</a>
+      <a href="{{ "docs/3.6/en/txt/Bugzilla-Guide.txt" | absolute_url }}">[Text]</a>
       </td>
       <td>
-      <a href="{{ "3.6/en/html/api/" | absolute_url }}">[APIs, including XML-RPC and JSON-RPC]</a>
+      <a href="{{ "docs/3.6/en/html/api/" | absolute_url }}">[APIs, including XML-RPC and JSON-RPC]</a>
       </td>
   </tr>
   <tr><td>Bugzilla 3.4.14</td>
       <td></td>
       <td>
-      <a href="{{ "3.4/en/html/" | absolute_url }}">[Online HTML]</a>
-      <a href="{{ "3.4/en/pdf/Bugzilla-Guide.pdf" | absolute_url }}">[PDF]</a>
-      <a href="{{ "3.4/en/txt/Bugzilla-Guide.txt" | absolute_url }}">[Text]</a>
+      <a href="{{ "docs/3.4/en/html/" | absolute_url }}">[Online HTML]</a>
+      <a href="{{ "docs/3.4/en/pdf/Bugzilla-Guide.pdf" | absolute_url }}">[PDF]</a>
+      <a href="{{ "docs/3.4/en/txt/Bugzilla-Guide.txt" | absolute_url }}">[Text]</a>
       </td>
       <td>
-      <a href="{{ "3.4/en/html/api/" | absolute_url }}">[APIs, including XML-RPC and JSON-RPC]</a>
+      <a href="{{ "docs/3.4/en/html/api/" | absolute_url }}">[APIs, including XML-RPC and JSON-RPC]</a>
       </td>
   </tr>
   <tr><td>Bugzilla 3.2.10</td>
       <td></td>
       <td>
-      <a href="{{ "3.2/en/html/" | absolute_url }}">[Online HTML]</a>
-      <a href="{{ "3.2/en/pdf/Bugzilla-Guide.pdf" | absolute_url }}">[PDF]</a>
-      <a href="{{ "3.2/en/txt/Bugzilla-Guide.txt" | absolute_url }}">[Text]</a>
+      <a href="{{ "docs/3.2/en/html/" | absolute_url }}">[Online HTML]</a>
+      <a href="{{ "docs/3.2/en/pdf/Bugzilla-Guide.pdf" | absolute_url }}">[PDF]</a>
+      <a href="{{ "docs/3.2/en/txt/Bugzilla-Guide.txt" | absolute_url }}">[Text]</a>
       </td>
       <td>
-      <a href="{{ "3.2/en/html/api/" | absolute_url }}">[APIs, including XML-RPC and JSON-RPC]</a>
+      <a href="{{ "docs/3.2/en/html/api/" | absolute_url }}">[APIs, including XML-RPC and JSON-RPC]</a>
       </td>
   </tr>
   <tr><td>Bugzilla 3.0.11</td>
       <td></td>
       <td>
-      <a href="{{ "3.0/html/" | absolute_url }}">[Online HTML]</a>
-      <a href="{{ "3.0/pdf/Bugzilla-Guide.pdf" | absolute_url }}">[PDF]</a>
-      <a href="{{ "3.0/txt/Bugzilla-Guide.txt" | absolute_url }}">[Text]</a>
+      <a href="{{ "docs/3.0/html/" | absolute_url }}">[Online HTML]</a>
+      <a href="{{ "docs/3.0/pdf/Bugzilla-Guide.pdf" | absolute_url }}">[PDF]</a>
+      <a href="{{ "docs/3.0/txt/Bugzilla-Guide.txt" | absolute_url }}">[Text]</a>
       </td>
       <td>
-      <a href="{{ "3.0/html/api/" | absolute_url }}">[APIs, including XML-RPC and JSON-RPC]</a>
+      <a href="{{ "docs/3.0/html/api/" | absolute_url }}">[APIs, including XML-RPC and JSON-RPC]</a>
       </td>
   </tr>
   <tr><td>Bugzilla 2.22.7</td>
       <td></td>
       <td>
-      <a href="{{ "2.22/html/" | absolute_url }}">[Online HTML]</a>
-      <a href="{{ "2.22/pdf/Bugzilla-Guide.pdf" | absolute_url }}">[PDF]</a>
-      <a href="{{ "2.22/txt/Bugzilla-Guide.txt" | absolute_url }}">[Text]</a>
+      <a href="{{ "docs/2.22/html/" | absolute_url }}">[Online HTML]</a>
+      <a href="{{ "docs/2.22/pdf/Bugzilla-Guide.pdf" | absolute_url }}">[PDF]</a>
+      <a href="{{ "docs/2.22/txt/Bugzilla-Guide.txt" | absolute_url }}">[Text]</a>
       </td>
       <td></td>
   </tr>
   <tr><td>Bugzilla 2.20.7</td>
       <td></td>
       <td>
-      <a href="{{ "2.20/html/" | absolute_url }}">[Online HTML]</a>
-      <a href="{{ "2.20/pdf/Bugzilla-Guide.pdf" | absolute_url }}">[PDF]</a>
-      <a href={{ "2.20/txt/Bugzilla-Guide.txt" | absolute_url }}"">[Text]</a>
+      <a href="{{ "docs/2.20/html/" | absolute_url }}">[Online HTML]</a>
+      <a href="{{ "docs/2.20/pdf/Bugzilla-Guide.pdf" | absolute_url }}">[PDF]</a>
+      <a href="{{ "docs/2.20/txt/Bugzilla-Guide.txt" | absolute_url }}">[Text]</a>
       </td>
       <td></td>
   </tr>
   <tr><td>Bugzilla 2.18.6</td>
       <td></td>
       <td>
-      <a href="{{ "2.18/html/" | absolute_url }}">[Online HTML]</a>
-      <a href="{{ "2.18/pdf/Bugzilla-Guide.pdf" | absolute_url }}">[PDF]</a>
-      <a href="{{ "2.18/txt/Bugzilla-Guide.txt" | absolute_url }}">[Text]</a>
+      <a href="{{ "docs/2.18/html/" | absolute_url }}">[Online HTML]</a>
+      <a href="{{ "docs/2.18/pdf/Bugzilla-Guide.pdf" | absolute_url }}">[PDF]</a>
+      <a href="{{ "docs/2.18/txt/Bugzilla-Guide.txt" | absolute_url }}">[Text]</a>
       </td>
       <td></td>
   </tr>
   <tr><td>Bugzilla 2.16.11</td>
       <td></td>
       <td>
-      <a href="{{ "2.16/html/" | absolute_url }}">[Online HTML]</a>
-      <a href="{{ "2.16/pdf/Bugzilla-Guide.pdf" | absolute_url }}">[PDF]</a>
-      <a href="{{ "2.16/txt/Bugzilla-Guide.txt" | absolute_url }}">[Text]</a>
+      <a href="{{ "docs/2.16/html/" | absolute_url }}">[Online HTML]</a>
+      <a href="{{ "docs/2.16/pdf/Bugzilla-Guide.pdf" | absolute_url }}">[PDF]</a>
+      <a href="{{ "docs/2.16/txt/Bugzilla-Guide.txt" | absolute_url }}">[Text]</a>
       </td>
       <td></td>
   </tr>