2024-09-04 Documentation WG Meeting notes

All public Working Group meetings follow the Recording Policy for Open edX Meetings

Date

Sep 4, 2024

Progress on WG Charter, Co-Chair Needed

Time	Item	Notes

Time	Item	Notes
10am-10:09am	WG Goal / Formation Recap	Discussed origins of the WG, from Open edX conference The exact comment voted on at the conference was: How can we substantially improve the documentation? (25 votes, the most voted topic) there were several cases of people wanting to use Open edX but it was cumbersome to figure out where to start easy access / reference was also an issue (how to find certain things, etc.)
10:09-10:12	Documentation Funding possibility	Perhaps Axim would be able to support educator documentation improvements but there are many other segments / groups (Not a commitment, just flagging that not all needs can be covered
10:12:- 10:16	Documentation Challenges limit Platform growth	Many documentation challenges exist, including helping new people to the platform / ecosystem get started Developers, adopters, educators, etc - lots of different segments and needs

	Challenges and Roles	https://docs.google.com/spreadsheets/d/1U7_OyE5O6VEHt4t5qvg3TX0kznfaOzIR7fk7ZDTnoD4/edit?gid=584346222#gid=584346222 from the last meeting.

Remove “Course Operators” persona. Please review PR here: Remove the Course Operators persona by sarina · Pull Request #562 · openedx/docs.openedx.org
Second meeting of the month will be a “working” meeting. Topic of September’s:

* Spend 15 minutes finalizing definitions of educator, developer, and site operator
* Spend remaining time going through empty pages and figuring out what we might want to add - eg, some headers prompting people to contribute content, a message like Wikipedia has like "this is a stub! Please contribute!", or remove the page. We might consider adding additional page stubs as well. We'll focus first on Site Operators, so if you have a more technical team member you can bring, that would be awesome!