I’m summarizing the contents of the doc to the best of my ability. Please do correct me if I got anything wrong here:
Starting a Docs WG charter
Info on how to begin a WG charter: Example PSF Workgroup Page - PSF Wiki
@willingc has a draft of the charter.
Once the charter is ready, bring this to the Steering Council for approval.
We can then kick off a monthly meeting.
Scope of the Docs WG
See details of Carol’s language summit presentation: CPython Documentation: The Next 5 Years - Speaker Deck
The workgroup will cover all documentation related issues and pull requests, but not the infrastructure/tooling, and not internationalization. There is already a translation workgroup coordinated by @julien. Ensure that Julien is included and aware of the work in this WG.
The workgroup will select members to be in the Python documentation editorial board. The editorial board should include broad and diverse members, non core developers, especially those with technical writing skills, documentarians, or experienced book authors.
We also recommend doing documentation sprints.
Monthly docs meeting
Meeting should have alternate schedule to accommodate members in different timezones. Be a community-focused meeting and welcome input from the wider community. Set up an agenda ahead of time. Keep records and meeting minutes, perhaps in GitHub.
What are our next steps?
-
Finish up the WG charter. @willingc where are we on this? Can I share this with @jojablonski so she can help review?
-
Bring forth the WG charter to Steering Council.
-
Set up the kick-off meeting. What video communication service will be used? Perhaps @ewa.jodlowska or The PSF can recommend one for the WG, or help provide access.
-
Set up documentation team Github repo. Perhaps this should wait until after the WG charter is approved.
-
During the sprint, I offered to help organize and schedule meetings and implement some automation whenever possible. I’m still open to help wrangle folks and get us all organized, but automation might be a different matter, now that I no longer have unlimited access to automation tooling (it was a perk from previous job).