2024-09-04 Documentation WG Meeting notes

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

 Date

Sep 4, 2024

Recording & Transcript

Always available here: Documentation WG Recordings - Google Drive

 Participants

  • @Marco Morales

  • @Sarina Canelake

  • @Peter Pinch

  • @Michelle Philbrick

  • @John Swope

  • @Ana Paula Gómez Duarte

  • @Glib Glugovskiy

  • @Maria Fernanda Magallanes Z

 Goals

Progress on WG Charter, Co-Chair Needed

  •  

 Discussion topics

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

Documentators Working Group - Initial Document from the last meeting.

 Action items

 Decisions

  1. Remove “Course Operators” persona. Please review PR here: Remove the Course Operators persona by sarina · Pull Request #562 · openedx/docs.openedx.org
  2. 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!