apache · jiayuasu · Sep 22, 2026 · Sep 22, 2026 · Sep 22, 2026
@@ -146,6 +146,27 @@ jobs:
           else
             echo "Archived documentation already noindexed; nothing to commit."
           fi
+      - name: Publish root 404 page
+        # Missing URLs currently hit Apache httpd's default Not Found page.
+        # Copy a standalone page (not generated by MkDocs) to the site root
+        # and set ErrorDocument so visitors actually see it. See GH-2426.
+        if: ${{ github.event_name != 'pull_request' && github.repository == 'apache/sedona' }}
+        run: |
+          if [[ ! -d website-branch ]]; then
+            git fetch origin website --depth=1
+            git worktree add website-branch FETCH_HEAD
+          fi
+          git -C website-branch config user.name "github-actions[bot]"
+          git -C website-branch config user.email "41898282+github-actions[bot]@users.noreply.github.com"
+          cp docs-overrides/root-404.html website-branch/404.html
+          cp docs-overrides/htaccess-root website-branch/.htaccess
+          git -C website-branch add 404.html .htaccess
+          if [[ -n "$(git -C website-branch status --porcelain)" ]]; then
+            git -C website-branch commit -m "Publish branded 404 page at the site root"
+            git -C website-branch push origin HEAD:website
+          else
+            echo "Root 404 page already current; nothing to commit."
+          fi
       - run: mkdir staging
       - run: cp -r site/* staging/
       - uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1

@@ -0,0 +1,18 @@
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+ErrorDocument 404 /404.html
@@ -0,0 +1,94 @@
+<!--
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements.  See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership.  The ASF licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License.  You may obtain a copy of the License at
+
+  http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied.  See the License for the
+specific language governing permissions and limitations
+under the License.
+-->
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <meta name="robots" content="noindex" />
+    <title>Page not found – Apache Sedona</title>
+    <style>
+      body {
+        margin: 0;
+        min-height: 100vh;
+        display: flex;
+        flex-direction: column;
+        font-family: system-ui, sans-serif;
+        color: #1c1c1c;
+        background: #fff;
+      }
+      main {
+        flex: 1;
+        max-width: 40rem;
+        margin: 0 auto;
+        padding: 4rem 1.5rem;
+      }
+      h1 { font-size: 1.75rem; }
+      p { line-height: 1.5; }
+      .links a {
+        display: inline-block;
+        margin: 0.25rem 0.5rem 0.25rem 0;
+        padding: 0.5rem 1rem;
+        border-radius: 0.5rem;
+        text-decoration: none;
+        color: #fff;
+        background: #ca463a;
+      }
+      .links a:hover { background: #ea5547; }
+      footer {
+        padding: 1rem 1.5rem 1.5rem;
+        font-size: 0.8rem;
+        color: #555;
+      }
+      footer a { color: #ca463a; }
+    </style>
+  </head>
+  <body>
+    <main>
+      <h1>Page not found</h1>
+      <p>
+        This URL is not part of the Apache Sedona documentation.
+        Try the home page, or jump to SedonaSpark or SedonaDB.
+      </p>
+      <p class="links">
+        <a href="/latest/">Home</a>
+        <a href="/latest/sedonaspark/">SedonaSpark</a>
+        <a href="/sedonadb/">SedonaDB</a>
+        <a href="https://github.com/apache/sedona">GitHub</a>
+      </p>
+    </main>
+    <footer>
+      <p>
+        <a href="https://www.apache.org/">Copyright &copy; The Apache Software Foundation</a> |
+        <a href="https://www.apache.org/licenses/">License</a> |
+        <a href="https://www.apache.org/events/current-event">Events</a> |
+        <a href="https://www.apache.org/foundation/sponsorship.html">Sponsorship</a> |
+        <a href="https://www.apache.org/foundation/thanks.html">Thanks</a> |
+        <a href="https://www.apache.org/security/">Security</a> |
+        <a href="https://privacy.apache.org/policies/privacy-policy-public.html">Privacy</a> |
+        <a href="https://www.apache.org/foundation/marks/">Trademarks</a>
+      </p>
+      <p>
+        Apache Sedona, Sedona, Apache, the Apache feather logo, and the Apache Sedona project logo
+        are either registered trademarks or trademarks of The Apache Software Foundation
+        in the United States and other countries.
+      </p>
+    </footer>
+  </body>
+</html>