[ https://issues.apache.org/jira/browse/GSOC-300?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=17932667#comment-17932667 ]
Trevor Grant edited comment on GSOC-300 at 3/5/25 3:10 PM: ----------------------------------------------------------- [~solomax] can you send instructions on how to? I've spent 10 minutes poking around the site, it's possible I also don't have sufficient privileges). I can also open a new issue back on GSOC if that's what's needed. (ffr if you ping me on the asf slack I can respond quicker) EDIT: Typical, I look and I look, I finally give up and ask for help, and the solution is clear. I moved it back. was (Author: rawkintrevo): [~solomax] can you send instructions on how to? I've spent 10 minutes poking around the site, it's possible I also don't have sufficient privileges). I can also open a new issue back on GSOC if that's what's needed. (ffr if you ping me on the asf slack I can respond quicker) > Apache Mahout: Refactoring the Website > -------------------------------------- > > Key: GSOC-300 > URL: https://issues.apache.org/jira/browse/GSOC-300 > Project: Comdev GSOC > Issue Type: Wish > Reporter: Trevor Grant > Priority: Major > Labels: full-time, 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) --------------------------------------------------------------------- To unsubscribe, e-mail: gsoc-unsubscr...@community.apache.org For additional commands, e-mail: gsoc-h...@community.apache.org