This is an automated email from the ASF dual-hosted git repository.
rawkintrevo pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/mahout.git
The following commit(s) were added to refs/heads/main by this push:
new 0cdd47646 Add custom 404 page and redirects for legacy documentation
(#835)
0cdd47646 is described below
commit 0cdd47646a4531916ce0e0ba7734b2c13acc0c44
Author: Guan-Ming (Wesley) Chiu <[email protected]>
AuthorDate: Sat Jan 17 01:11:27 2026 +0800
Add custom 404 page and redirects for legacy documentation (#835)
* Add custom 404 page and redirects for legacy documentation
* Update status code
---
website/.htaccess | 38 ++++++++++++++++++++++++++++++++++++
website/404.html | 58 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
2 files changed, 96 insertions(+)
diff --git a/website/.htaccess b/website/.htaccess
new file mode 100644
index 000000000..98b7a28a9
--- /dev/null
+++ b/website/.htaccess
@@ -0,0 +1,38 @@
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.
+
+# Enable custom error pages
+ErrorDocument 404 /404.html
+ErrorDocument 410 /404.html
+
+# Legacy documentation paths
+# These paths were removed in January 2026 when Mahout transitioned to Qumat
+
+# Legacy MapReduce algorithm documentation
+RedirectMatch 410 ^/users/(.*)$
+RedirectMatch 410 ^/documentation/users/(.*)$
+RedirectMatch 410 ^/documentation/tutorials/(.*)$
+
+# Legacy classification docs
+RedirectMatch 410 ^/users/classification/(.*)$
+
+# Legacy clustering docs
+RedirectMatch 410 ^/users/clustering/(.*)$
+
+# Legacy recommender docs
+RedirectMatch 410 ^/users/recommender/(.*)$
+
+# Legacy Spark/Flink bindings
+RedirectMatch 410 ^/users/sparkbindings/(.*)$
+RedirectMatch 410 ^/users/flinkbindings/(.*)$
+
+# Legacy basics/quickstart
+RedirectMatch 410 ^/users/basics/(.*)$
+
+# Old release notes
+RedirectMatch 410 ^/release-notes/(.*)$
+
+# Redirect old qumat documentation path to new structure
+RedirectMatch 301 ^/documentation/qumat/?$ /qumat/
+RedirectMatch 301 ^/quantum-computing-primer/?$
/qumat/quantum-computing-primer/
+RedirectMatch 301 ^/quantum-computing-primer/(.*)$
/qumat/quantum-computing-primer/$1
diff --git a/website/404.html b/website/404.html
new file mode 100644
index 000000000..631668f6b
--- /dev/null
+++ b/website/404.html
@@ -0,0 +1,58 @@
+---
+layout: page
+title: Page Not Found
+permalink: /404.html
+---
+
+
+<div style="background-color: #fff3cd; color: #856404; border: 1px solid
#ffeeba; padding: 20px; border-radius: 5px; margin-bottom: 30px;">
+ <strong>Looking for classic Mahout documentation?</strong>
+ <p style="margin-bottom: 0; margin-top: 10px;">
+ Apache Mahout has evolved significantly over its 15+ year history. The
legacy MapReduce and Samsara
+ documentation you may be looking for has been retired. Mahout now focuses
on
+ <strong>Qumat</strong>, our quantum computing library.
+ </p>
+</div>
+
+<div style="text-align: center; padding: 40px 20px;">
+ <h1 style="font-size: 4rem; color: #dc3545; margin-bottom: 0;">404</h1>
+ <h2 style="color: #6c757d;">Page Not Found</h2>
+</div>
+
+<h3>Current Documentation</h3>
+
+<p>Explore the current Apache Mahout project:</p>
+
+<ul>
+ <li><a href="/qumat/">Qumat Overview</a> - High-level quantum computing
library</li>
+ <li><a href="/qumat/core/">Qumat Core</a> - Build quantum circuits with a
unified API for Qiskit, Cirq, and Amazon Braket</li>
+ <li><a href="/qumat/qdp/">QDP (Quantum Data Plane)</a> - GPU-accelerated
quantum data encoding</li>
+ <li><a href="/qumat/quantum-computing-primer/">Quantum Computing Primer</a>
- Learn quantum computing fundamentals</li>
+</ul>
+
+<h3>Looking for Historical Documentation?</h3>
+
+<p>
+ If you need to reference legacy Mahout documentation (MapReduce algorithms,
classic machine learning,
+ Spark/Flink bindings, Samsara), you can find archived versions on the
+ <a href="https://web.archive.org/web/*/mahout.apache.org/*"; target="_blank"
rel="noopener">Internet Archive Wayback Machine</a>.
+</p>
+
+<p>Archived documentation:</p>
+<ul>
+ <li><a
href="https://web.archive.org/web/20190827090545/http://mahout.apache.org/users/basics/quickstart.html";
target="_blank" rel="noopener">Quick Start Guide</a></li>
+ <li><a
href="https://web.archive.org/web/20180916081158/http://mahout.apache.org/users/clustering/clustering-of-synthetic-control-data.html";
target="_blank" rel="noopener">Clustering Documentation</a></li>
+ <li><a
href="https://web.archive.org/web/20200220174941/http://mahout.apache.org/users/classification/bayesian.html";
target="_blank" rel="noopener">Classification - Bayesian</a></li>
+ <li><a
href="https://web.archive.org/web/20200208114131/http://mahout.apache.org/users/recommender/recommender-documentation.html";
target="_blank" rel="noopener">Recommender Documentation</a></li>
+</ul>
+
+<h3>Need Help?</h3>
+
+<p>
+ <a href="https://github.com/apache/mahout/issues";>Open an issue on
GitHub</a> or join the
+ <a href="mailto:[email protected]";>dev mailing list</a> if you have
questions.
+</p>
+
+<p style="text-align: center; margin-top: 40px;">
+ <a href="/" class="btn btn-primary">Return to Homepage</a>
+</p>
