Hello to Vietnam!
If you hover cursor over time and click it, you will see local time.
The workshop will be recorded and shared on PeerTube, so you can watch it later.
The November/December timetable caters for people in Asia Pacific.
1 Like
thats nice didint see that option
1 Like
Big thanks to new comers, Justin, Joseph and Peter for joining the Docs workshop today.
Live editing of documentation is tipping us over the edge at places ;), but we were thrilled to show how Quick Docs can be improved. Thanks again, Peter, for you walking through the Pagure UI and PR process.
The workshop was recorded to the hard disk of my laptop. The link to PeerTube will be shared here once editing is completed (ETA 30 Oct 2023).
After the video is posted, we love to hear your feedback and make the workshop more interactive! 
We are excited to prepare the next one.
Thanks @hankuoffroad and @pboy for putting this together. If you ever wanted a demo for a CLI-based workflow and/or how to build and test docs locally, I’d be happy to demo that sometime.
I am also thinking, maybe we could triage some “good first issues” across the Fedora Docs repos? Then we could point newcomers to some issues to get hands-on.
Thanks for your heads up on a CLI-based workflow. I have a rough schedule for next year, which includes local authoring environment. I’ll pencil that in for you.
Good first issues consist of various domain like UX, design, a11y beyond technical review. It seems to me that we could pick one domain and one Git forge at a time. My worry is if we are ambitious in dealing with many topics at once, we might scare people away.
To my mind, up-to-dateness of docs is the most neglected part due to Docs manpower and team focus.
If we publish workshop program well in advance, we will expect right audience to come along.
Hi folks, please find the video link to the workshop.
November meeting link is updated in the Fedocal.
Time: 16 November 2023 08:00-08:30 UTC
Target audience: beginner
Program:
- Intro to Docs team and Docs Home page
- Quick Docs
- Docs toolset, how we work
- Ask the Experts
- User Docs vs Team Docs
Please view local time below.
08:00 in London
09:00 in Berlin
10:00 in Athens
11:00 in Nairobi, Kenya
12:00 in Abu Dhabi
13:30 in Bengaluru India
16:00 in Singapore and Kuala Lumpur
17:00 in Seoul
19:00 in Sydney
22:00 in Honolulu, Hawaii
1 Like
Happy to see new comers, Ioannis, Sandra, Grust joining the workshop and interactions with @pboy and me today.
Following on from Q&A session, find the link below.
- General guide
– Chat: Leave a comment in Matrix Docs room (Room URL: https://matrix.to/#/#docs:fedoraproject.org)
– Meeting: Check the Fedora Calendar docs - Fedocal
– Discourse: If you want new content for workshop, share your suggestions in Discussion thread docs-team tag
Peter and I as well as Docs board members and broader Fedora community will be able to guide new comers to find answer to any questions.
- Antora Docs build repo
– Docs Website · GitLab
Ioannis, check this repo and if you have any questions around Docs build, reach out to @darknao and @pbokoc
- Fedora account creation
– https://accounts.fedoraproject.org/
Looking forward to helping you get the most out of Fedora community.
1 Like
@hankuoffroad Thanks for organizing the workshop. I was glad to participate and I think the instrucitonal/mentoring approach is good.
I had a question though. My original impression for these sessions was that they were going to be an informal hour where people could show up together in a live call to work on Fedora Docs together. This could mean that the call is quiet for parts, but if someone needs help or wants feedback, they can ask for it in the call. This was not how the last session was organized, which was my misunderstanding.
So, my question is, does the informal writing time seem like something that would be useful?
My challenge is that I do not get a lot of focused time to work on docs. I like the idea of an hour every week or every other week where I can jump into a call with other Fedora Docs folks to just… write docs! If I need feedback or second opinions, I can quickly ask for it in the call. Otherwise, I can just work on my own thing and build the active habit of writing.
I am curious for other thoughts or if anyone else would be interested in this. I could possibly host sessions like this but I would like to do it only if others would also benefit.
Program agenda of Docs workshop alternates each month, focused on onboarding, introduction and demo. Both cater for new comers and encourages interactions. On even months, we have quiet writing time for 40 minutes. I would keep this format at least for 1 year.
I’m in.
I see. I did not know the structure of the program agenda much until now.
I could run a fortnightly call every Friday for Fedora Docs writers from across the project. I would intend to keep it low-key: no agenda, self-structured exploration, and collaborative input when helpful. My goal would be to help build a more focused discipline around writing Fedora Docs, while also creating an office hours of sorts for anyone who needs help or support with Antora and AsciiDoc while contributing to Fedora.
If that sounds complementary to the 2024 program agenda, I can put it on the Fedora Calendar and set up a calendar invite for Fedora Docs team members.
As writing workshop evolves and continues with feedback, we can close this thread. Could anyone with right privileges close this?
We will collect feedback via LimeSurvey, during workshop and Matrix Docs chat room, so we can improve curriculum and deliver high quality content.