As a precursor prior to the meeting, I offer my suggestions to item 3 led by @pboy , and timeline to item 2 led by @hankuoffroad.
I suspect you @pboy appear oversubscribed in general. Can I and any other colleagues help you out?
Quick Docs improvement
Categories and tags
I’m thinking of bulk update, rather than weaving through each file one by one and opening PR every time.
- Clone files and copy all file names in main / modules / ROOT / pages
(maybe it is less messy than extracting file names in nav.adoc) - paste them onto LIbreOffice calc and add two columns
- cross-reference file names and content
- update categories and tags
- set text manipulation to add two lines (category and tag) on the header line of file
- git commit all changes
Please come forward to making suggestions if you have a better way or know a native tool/extension in Antora that I’m not aware of.
Contributor onboarding
Call to action banner on Docs home page
Question: Where to put it?
Role-based CTA suggestions: technical writer, UX/UI contribution, document maintenance
Timeline
Agreement on the location and role names: end of June 2023
Open issue ticket: early July 2023
PR and review: end of July 2023
Completion: end of August 2023
Docs hackfest revival
As presented on F38 release party, I’ll keep you in the loop via the Magazine article.
Frequency: monthly, starting from September 2023
“Docs Writing Hour” was active between 2018 and 2020. See the meeting description on Fedocal below.
Join members of the docs team in #fedora-docs for writing time. This is a great time to focus on writing and talk about challenges and blockers related to producing content.
There is no formal schedule for this meeting. Attendees should show up and use this as a way to block writing time into their week.
What happened since? Could anyone who participated in Docs writing hour talk about any lessons to be learned or unlearned?
Project management
To keep things in order and get traction from interested individuals, I would like to encourage Docs team to use Epics in GitLab to manage tasks related to Docs website.
Why?
- I don’t want people to be barraged with unsolicited (often convoluted and long) essays posted in discourse.
- I lose momentum/interest if the task/project has no time goals or estimate (same goes for my personal affairs and any types of hobbies).
- Discourse is not project management tool (never meant to be). Let’s choose a right tool for the job at hand.