Charter
The Documentation Working Group focuses on:
Comprehensive Documentation: Develop Assist in developing detailed guides and references for all user roles (educators, course operators, site operators, and developers).
Improved Discoverability: Implement strategies to make documentation accessible, easy to find, and navigate (with a clear structure, table of contents, indexing, and search functionalities).
Enhanced AvailabilityReliability: Ensure that documentation is always up-to-date and easily accessible.Focused Efforts: Prioritize Read the Docs platform enhancements to ensure documentation is consistently accurate, relevant, and up-to-date
A Sensible Ecosystem: Prioritize and support an Open edX® documentation ecosystem that has clear sources of truth that are best suited for their purpose or need.
Community Engagement: Encourage a collaborative environment where community members can contribute and find support.
...
| Info |
|---|
All public Working Group meetings follow the Recording Policy for Open edX Meetings |
Join our Slack Channel, #documentation (may be updated) #wg-documentation
Join our monthly meeting meetings (to be linked)
How we make decisions
...
By default, decisions are made by lazy consensus:
Lazy consensus means that when you are convinced that you know what the community would like to see happen, you can assume that you have consensus in favor of the proposed work and and get on with it. You don’t have to insist people discuss and/or approve your plan, and you certainly don’t need to call a vote to get approval. You just assume you have the community’s support unless someone says otherwise.
Lazy consensus works only if you communicate with enough advance notice, and with enough details that people who would object have the time and the necessary information to do so. Generally speaking, it’s better to over-communicate.
How to work on issues
To be defined
Members
To be defined
Leadership
TBD
...
We can organize an internal sprint to focus on 2 or 3 key documentation issues to ensure that important and urgent updates are promptly addressed and have other issues to allow contributors to select and work on topics relevant to their expertise.
We can prioritize by accuracy, clarity, relevance, and discoverability.
https://github.com/orgs/openedx/projects/32/views/2
Members
Leadership
Co-Chair - You
Co-Chair - Sarina Canelake