[jira] [Moved] (MAHOUT-2217) Apache Mahout: Refactoring the Website

["Maxim Solodovnik (Jira)" <ji...@apache.org>]

     [ https://issues.apache.org/jira/browse/MAHOUT-2217?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Maxim Solodovnik moved GSOC-298 to MAHOUT-2217:
-----------------------------------------------

         Key: MAHOUT-2217  (was: GSOC-298)
    Workflow: no-reopen-closed, patch-avail  (was: Default workflow, editable Closed status)
     Project: Mahout  (was: Comdev GSOC)

> Apache Mahout: Refactoring the Website
> --------------------------------------
>
>                 Key: MAHOUT-2217
>                 URL: https://issues.apache.org/jira/browse/MAHOUT-2217
>             Project: Mahout
>          Issue Type: Wish
>            Reporter: Trevor Grant
>            Priority: Major
>              Labels: gsoc2025, mahout, mentor
>
> h2. *Synopsis*
> Apache Mahout has been evolving, with a recent shift in focus toward {*}Quantum Computing (Qumat){*}. However, the official website does not currently reflect this transition, making it difficult for developers and contributors to engage with Mahout’s new direction. Additionally, legacy components like *MapReduce and Samsara* are no longer actively developed but still occupy prominent space on the website.
> This project aims to *refactor the Apache Mahout website* to:
>  # *Bring Quantum Computing (Qumat) front and center* as the new core focus of the project.
>  # *Deprecate outdated technologies (MapReduce and Samsara)* while keeping the documentation intact with clear deprecation warnings.
>  # *Improve website structure, navigation, and content organization* to enhance accessibility and usability.
> By executing these changes, this project will ensure that new and existing users can quickly access relevant information while keeping historical documentation available in a structured manner.
> h2. *Benefits to the Community*
> A well-organized and up-to-date website is essential for any open-source project. This proposal offers multiple benefits to the Apache Mahout community:
> h3. *1. Highlighting Quantum Computing (Qumat)*
>  * Restructure the website so that {*}Qumat-related content is the primary focus{*}.
>  * Ensure that all documentation, blogs, and tutorials related to Qumat are *easily discoverable* from the homepage.
> h3. *2. Deprecating MapReduce and Samsara*
>  * Add *clear deprecation warnings* to pages related to MapReduce and Samsara.
>  * Ensure these technologies remain accessible for historical reference but {*}indicate that they are no longer actively maintained{*}.
> h3. *3. Improved Navigation and Accessibility*
>  * Design a *more intuitive navigation system* for easy exploration of different sections.
>  * Ensure smooth access to {*}documentation, blogs, and learning resources{*}.
> h3. *4. Updating Outdated Content*
>  * Perform a *full website audit* to identify obsolete articles, guides, and references.
>  * Refresh and rewrite content where necessary, focusing on Mahout’s latest advancements.
> h3. *5. Engaging New Contributors*
>  * A modern, user-friendly website will attract *more developers, researchers, and open-source contributors* to the project.
> h2. *Deliverables*
> h3. *1. Website Restructuring*
>  * Modify the *homepage and navigation bar* to prominently feature *Quantum Computing (Qumat)* as the main focus.
>  * Ensure Qumat-related documentation and blog posts are front and center.
> h3. *2. Deprecation of MapReduce and Samsara*
>  * Add *banner notifications* on all MapReduce and Samsara pages marking them as deprecated.
>  * Ensure clear explanations so users understand these technologies are no longer in active development.
> h3. *3. Content Review & Updates*
>  * Perform a *recursive LS audit* to identify outdated and redundant content.
>  * Update old blogs and articles to align with Mahout’s latest developments.
> h3. *4. Improved Website Navigation*
>  * Implement a *modern, responsive, and mobile-friendly* navigation system.
>  * Optimize loading speed and ensure smooth user experience.
> h3. *5. Documentation Enhancement*
>  * Ensure all {*}essential documentation is accessible from the homepage{*}.
>  * Improve the *readability and structure* of the docs.
> h2. *Technical Details*
> The project will utilize:
>  * *HTML, CSS, JavaScript* for website front-end improvements.
>  * *Modern front-end frameworks* (if required) to enhance UX/UI.
>  * *Shell scripting or Python* to perform a *recursive LS* audit of the website structure.
>  * *Version control via GitHub* for tracking changes and ensuring collaboration.
> h2. *Expected Outcomes*
> ✅ A *refactored website* that clearly emphasizes {*}Quantum Computing (Qumat){*}.
> ✅ A *deprecated but accessible* archive for MapReduce and Samsara.
> ✅ An *updated and well-structured content repository* for Mahout users and contributors.
> ✅ An *intuitive, user-friendly website* that engages both new and existing users.
> h2. *Timeline (12+ Weeks, Full-Time Commitment - 30 hrs/week)*
> h3. *Community Bonding (Weeks 1-2)*
>  * Engage with mentors and the Mahout community.
>  * Gather feedback on website restructuring priorities.
>  * Set up the development environment and review existing website architecture.
> h3. *Phase 1: Planning & Initial Development (Weeks 3-6)*
>  * Redesign homepage and navigation bar to prioritize {*}Qumat{*}.
>  * Identify and start modifying MapReduce and Samsara pages with {*}deprecation warnings{*}.
>  * Conduct a *recursive LS audit* to locate outdated files and redundant content.
> h3. *Phase 2: Implementation & Testing (Weeks 7-10)*
>  * Implement the *new website navigation* and homepage.
>  * Update and restructure documentation and blog content.
>  * Optimize the website’s *file structure* based on LS audit findings.
>  * Conduct extensive testing for {*}responsiveness, accessibility, and performance{*}.
> h3. *Phase 3: Content Finalization & Refinement (Weeks 11-12+)*
>  * Finalize deprecation notices for MapReduce and Samsara.
>  * Ensure {*}all Qumat-related content is easily accessible{*}.
>  * Perform last-minute optimizations and bug fixes.
>  * Gather final feedback from the community and document all changes.
> 🔹 *Total Timeline: 350+ hrs*
> h2. *Why This Should Be a GSoC Project*
> This project directly aligns with *Google Summer of Code’s mission* to enhance open-source software. By modernizing the Apache Mahout website, we ensure that its {*}new focus on Quantum Computing (Qumat) is clearly reflected{*}, making it easier for developers and researchers to engage with Mahout’s latest advancements.
> Additionally, this project is well-scoped for GSoC, combining {*}front-end development, content management, and structured auditing{*}—all crucial aspects for a website overhaul.
> h2. *Mentorship & Feasibility*
>  * The project has *clear, well-defined goals* and structured milestones.
>  * It will be mentored by an *experienced Apache Mahout maintainer* who is applying for the mentor role.
>  * The tasks are technically feasible within the GSoC timeframe.
> h2. *Conclusion*
> Refactoring the Apache Mahout website is *essential* for reflecting its *new focus on Quantum Computing (Qumat)* while ensuring historical documentation remains accessible. By modernizing the site, we enhance usability, improve accessibility, and help new users quickly understand Mahout’s direction.
> This project will *significantly enhance Mahout’s online presence* and ensure the community stays well-informed and engaged.
>  



--
This message was sent by Atlassian Jira
(v8.20.10#820010)