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: https://drive.google.com/drive/folders/1JSIPLlbL5Evz1rzvmJtYahTA49RePxfK

 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

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

 Action items

 Decisions

  1. Remove “Course Operators” persona. Please review PR here: https://github.com/openedx/docs.openedx.org/pull/562
  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!