Add deprecation banners to MapReduce and Samsara documentation pages (Updated Version). #533
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
This PR addresses #529 by adding clear deprecation banners to all documentation pages related to MapReduce and Samsara.
These banners notify users that these components are no longer actively maintained and encourage exploration of Qumat, Mahout’s new Quantum Computing framework.
✅ Changes Made:
Inserted styled HTML banners at the top of relevant .md files
Ensured content remains unchanged otherwise
Verified correct rendering in local build
Example Banner Text:
<div style="background-color: #fff3cd; color: #856404; border: 1px solid #ffeeba; padding: 15px; border-radius: 5px; margin-bottom: 20px;"> <strong>⚠️ Deprecation Notice:</strong> This component (<em>Mahout/Samsara</em>) is no longer actively maintained. It remains accessible for historical reference but is not recommended for new development. Please check out <a href="https://mahout.apache.org/quantum-computing-primer/" style="color: #0c5460; text-decoration: underline;">Qumat - Mahout's Quantum Computing Primer</a> for the latest innovations.</div>
✅Based on feedback, I’ve completed the following:
Created a new layout: deprecated-docs.html (copied from doc-page.html)
Injected the banner at the top of the layout
Updated only MapReduce and Samsara pages to use this layout (census done)
Ensured no impact on current or Qumat-related documentation
This approach keeps legacy content well-organized, avoids layout duplication, and ensures the banner only appears where needed.
Thanks again for the direction — let me know if you'd like any further refinements!