2024-11-06 Docs WG Meeting notes

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

 Date

Nov 6, 2024

 Participants

  • @Sarina Canelake

  • @Ana Paula Gómez Duarte

  • @Jesica Greco @Jesica Greco

  • @John Swope

  • @Deimer Morales

Heads up to @Peter Pinch who couldn’t make it today.

 Goals

  •  

 Discussion topics

 Action items

@John Swope will provide additional review/detail/syntax for see also, other points in the Style Guide
@Ana Paula Gómez Duarte and @Jesica Greco will review pages like https://docs.openedx.org/en/latest/documentors/references/doc_checklist.html and consolidate/remove pages when the Google docs are moved to the Docs site
@Ana Paula Gómez Duarte and @Jesica Greco need to move useful pages from https://draft-edx-style-guide.readthedocs.io/en/latest/index.html to the docs.openedx.org site
@Sarina Canelake will shut down the “draft-edx-style-guide” site when the pages are consolidated
@Peter Pinch we’d love if you have a few minutes this week to review any of the docs that Ana & Jesica have proposed (linked in the above table)

 Decisions

  1. We will not use or encourage use of Google Docs for people writing docs who don’t know how to engage with rST. Instead, encourage people to file GitHub Issues on the docs repo that the docs WG members can pick up and address.