...
The recent survey highlights a clear need for a unified better resource that details the processes and roles associated with onboarding and the ongoing responsibilities of Core Contributors. To address this, I propose the creation of a dynamic and comprehensive , comprehensive and easy-to-navigate "Open edX Handbook" that will be continuously updated and refined to meet the community’s evolving needs.
Initially, the handbook will involve relocating and consolidating existing Core Contributor information and expanding the information in a newly established space (eg. Similar to Open edX docs or the The OpenCraft Handbook). Over time, this space will evolve into a centralized, all-encompassing resource designed to enhance documentation accessibility, clarify information, and reduce information overload for the entire Open edX community, not just Core Contributors.
...
Support the Core Contributor onboarding process
Provide more in-depth guidance on Core Contributor processes and tooling
Help Core Contributors easily locate information relevant to their roles
Promote effective Core Contributor participation
Reduce reliance on community members for straightforward answers
Strengthen the Core Contributor community as a whole
Survey Results
Here are some key results from the survey that supports this initiative:
32% of the community rated onboarding experience as lacking, also citing content as too high-level. A handbook can support the onboarding course, consolidate and clarify information, and reduce overwhelm.
71.5% of the community have a limited understanding of Core Contributor Sprint Processes. Clear process documentation in a handbook can improve comprehension.
78.9% of the community want fewer communication tools. Contributors face low engagement on Slack and challenges with too many channels. Comprehensive guidelines for asynchronous communication could enhance engagement.
77.1% of the community would like more collaboration. Concerns include coordination issues and unequal engagement rights. The handbook can offer best practices to improve teamwork.
68.5% of the community struggle getting reviews. Contributors find it hard to locate PRs and receive timely feedback. The handbook can clarify review expectations and procedures.
65.7% of the community would like better planning of Core Contributor work. Including planning strategies in the handbook could boost productivity and help CCs better reach their commitments.
Solution
To address the challenges outlined in "Enhancing the Core Contributor Experience," I propose the following solutions to benefit both newcomers and the broader Core Contributor community:
...
Perform a thorough audit of
existing Core Contributor documentation and consolidate it into a well-organized central repository. This will address the current challenge of overwhelming and dispersed information. Additionally, ensure to review other projects related to the Documentation (ie. Working Group information) to identify potential overlaps or opportunities for collaboration. This effort should be done in collaboration with those maintaining the core contributor onboarding course.
Enhanced Content Order and Quality:
...
I propose an iterative approach to this project. To ensure a faster review process, I will assemble a team of dedicated collaborators and reviewers. This will facilitate faster content creation and timely feedback and enable continuous improvements throughout the development phases.
...
Phase 1: Define the New Handbook Structure (2 weeks)
Define Sections : Cassie Zamparini and one additional person (TBD)
Analyze survey feedback and existing Core Contributor information to outline the essential sections of the Handbook.
Initial Input Gathering: Cassie Zamparini and multiple volunteers (TBD)
Validate the proposed list of sections from with reviewers, and establish the priority order for section development.
...
Section-by-Section Development: Cassie Zamparini and multiple volunteers (TBD)
Weeks 1-2: Develop content for the highest-priority sections with the help of Core Contributor volunteers.
Weeks 3-4: Review and refine these sections based on feedback and publish the content.
Repeat Development Cycles:
Continue developing and refining additional sections in 4-week intervals, incorporating feedback and making iterative improvements as needed.
...