Follow-up with attendees after the event is difficult.
We need to get results from Lime Survey carried out in December 2023. (@jflory7 can you help?) [Edit: received, thanks. Responses seem helpful. We will continue post-event survey.]
Continue post-event survey all year round, so viewers of recording can share feedback.
Follow up with attendees are easier with Fedora Matrix room than JItsi public instance. We can use Jitsi in Matrix with little introduction for all Matrix users (Element client to use built-in Jitsi widget).
Target audience
You use Free and Open Source software run on Linux desktop and/or server to get the job done
You love to document tools, features, and how-to guides, which require care and maintenance to ensure technical accuracy and conformance to documentation style guide
You are interested in Docs toolchain
2024 workshop topics: if there are suggestions from LimeSurvey, we will review them.
Code-rich documents: convention and code comments (mainly Bash commands and scripts)
Release notes: 2 to 3 sessions
Presenters and co-host
One presenter (main host) per workshop to keep consistency in a session. Co-host is welcome to help out presenter and attendees.
Note: We will wait for LimeSurvey results and more feedback from Fedora community by 2024-01-16T00:00:00Z
If you want to volunteer for a main presenter of a workshop topic, discuss about repo/document pages and scenario in advance with the organizer - Hank Lee.
You’ll need a Matrix network account to join the workshop live and to interact with host and participants.
If you don’t already have an account you can create one via Element’s Create Account page. Element offers free desktop or mobile apps to join the workshop. Element also offers a web app that allows you to join from your browser.
Click green Join Conference button on Jitsi widget. See image down below.
Workshop host/moderator will toggle video call option on before the workshop.
If someone wants to participate with many of Fedora’s teams and the community, the best experience is to sign up for a Matrix account with a Fedora account. This automatically adds someone into the Fedora space, where they can find all the Fedora chat rooms:
I have a conflict so I can’t make that one, but I hope to hear how it goes!
It is not required and anyone can use a Matrix account from any homeserver. However, if someone intends to participate with many Fedora teams and the broader community, and also does not yet have an account, the best way to go is with a Fedora homeserver account because it automatically adds you as a member to the Fedora space on Matrix.
Fedora Documentation Room is open to a Matrix account from any homeserver.
If you are new to the Fedora Project and don’t have a Matrix account, we recommend you to create a Fedora Account and connect it with Matrix Account for best experience. Using a Matrix account with Fedora space (Fedora Chat) will make navigation of Fedora rooms easier and help access to Fedora tools such as Pagure (Git forge), Weblate (Translation), Fedocal (team calendar), and Discourse (discussion forum).
Fedora Account: link
Fedora Chat: link
Click ‘Continue with your Fedora Account’
Element offers free desktop or mobile apps to join the workshop. Element also offers a web app that allows you to join from your browser.
[Edited Jan 10]
Agenda (draft)
Please leave your comments if you want to take a part as a main presenter or moderator.
Topic
Time
Main presenter
Recording
Onboarding
1200-1230 UTC Jan 25
Hank Lee
No
Advanced techniques for editing and contributing to Fedora Docs
2000-2100 UTC Feb 22
Justin Flory
Yes
Onboarding
Mar
Looking for a moderator
No
Working on multiple repos
Apr
Hank Lee
Yes
Onboarding
May
Looking for a moderator
No
How to test documentation
Jun
Looking for a main presenter
Yes
Onboarding
July
Looking for a moderator
No
What makes good review? Break away from a lone writer
Aug
Looking for a main presenter and co-host
Yes
Note) If you’re sharing screen as presenter, join meeting using a Matrix-Element web app from Chromium/Chrome browser.
Hi guys, I’m back after some challenges at the start of the year. Three questions:
Regarding onboarding, so far we were a team of two (Hank and I), which went very well and we were able to gain experience so that the events got better and better. Should things be different now?
With regard to “advanced techniques …”, is there a content plan for this? Will it be compatible with our contributor documentation? Or should we update the documentation?
Regarding “How to test …” What do you mean by test here? On the tool side, we have local preview (still in need of improvement) and possibly vale. Anything else in the quiver?
I believe one presenter (main host) per workshop can keep consistency in a session. Co-host is welcome to help out presenter and attendees. So there is no change really. I put down my name for January and April. You are more than welcome to accompany me.
February workshop: Justin volunteered for this topic. Also I’m sure it is a good idea to rotate presenters, so people get fresh perspectives and skills. I’d love to learn from him and sit in passenger seat, not driver seat
Test documentation: I mean a basic quality control stuff before one pushes changes to main branch or remote fork for PR review. No, there are no new tools I consider. Local preview script, spell checker and style guide (whether Vale or other method to ensure style guide is met), that’s it.
Thanks for sharing. Much better readable as the image preview on Matrix. By the way, I’m still wondering how to join the Video session. Looking forward.
