18:31:10 #startmeeting docs 18:31:10 Meeting started Wed Jun 21 18:31:10 2023 UTC. 18:31:10 This meeting is logged and archived in a public location. 18:31:10 The chair is hankuoffroad[m]. Information about MeetBot at https://fedoraproject.org/wiki/Zodbot#Meeting_Functions. 18:31:10 Useful Commands: #action #agreed #halp #info #idea #link #topic. 18:31:10 The meeting name has been set to 'docs' 18:31:36 #topic Roll call 18:31:42 .hello riddled 18:31:43 ChristopherBush[: riddled 'Christopher Bush' 18:32:22 .hello hankuoffroad 18:32:23 hankuoffroad[m]: hankuoffroad 'Hank Lee' 18:32:40 ChristopherBush[: hi Chris 18:33:01 .hello hankuoffroad 18:33:02 ChristopherBush[: hankuoffroad 'Hank Lee' 18:33:19 let's wait for a few minutes to see who is present 18:33:23 ok 18:34:37 this is the first time I chair the Docs meeting, so please bear with me. 18:34:48 ok 18:35:28 Cool, we can start 18:35:36 oki 18:35:42 #topic Agenda 18:36:13 https://discussion.fedoraproject.org/t/docs-meeting-agenda-2023-06-21-utc-18-30/84463 18:36:34 let's skim through agenda for a bit. 18:38:25 we can come back to each topic after announcement. 18:38:44 #info Announcements 18:40:00 before we go through agenda, is there any announcements to make? 18:40:21 I dont have any 18:41:50 cool, let's go to each topic, then. 18:41:56 oki 18:42:09 #info Tickets review 18:42:52 there is no ticket flagged for the meeting on GitLab. There are two tickets flagged for “next meeting” on Quick Docs. 18:43:24 https://pagure.io/fedora-docs/quick-docs/issue/528 18:43:43 https://pagure.io/fedora-docs/quick-docs/issue/605 18:44:23 I am taking some time to learn asciidoc and antora so I will add more benefit to the team other than simple UI stuff. I would like to tackle the "Fedora on Raspberry Pi" issue after I am done learning. 18:44:25 ah, many thanks for your MR on scrollbar width 18:45:56 Thank you I had fun doing it 18:46:19 ChristopherBush[: Great. I've added a few commands for installation procedure, but I think you can improve that. I gather Peter Boy opened this ticket, so please check with him about your interest. 18:46:40 ok 18:47:43 Raspberry Pi has active supporters in various groups - server, IoT. I ran pi server for a year, and looking for a new project. I got distracted for many things like docs automation. 18:48:37 Yeah i have a raspberry pi and I am running raspberry pi os right now. I am looking to put Fedora on it. 18:48:45 ChristopherBush[: I love R Pi. I even went to a shop in Cambridge. 18:49:54 Now we are moving away from Pagure to exclusively GitLab? Correct? 18:49:58 ChristopherBush[: I ran Fedora server F35-F37 18:50:46 ChristopherBush[: Docs team uses two GIt forges. GitLab for Docs build and contributor pages. Pagure for Quick Docs. 18:51:16 Oh okay I will keep that in mind when I am looking for something to do. 18:52:24 When Antora was introduced, the key value prop was to support multi repo, which doesn't disrupt each working groups preference and ethos. 18:52:58 ok 18:53:49 it may be cumbersome for new starters, and there are debates whether to put everything on GItLab, but we are what we are. 18:54:23 It's not a problem. I am good at adapting and overcoming lol 18:54:37 thanks for your understanding 18:55:43 by the way, you were working on the other MR in GItLab, right? It is about the size of three buttons for contributions. 18:56:24 UX is not my specialism, but there will be many people who can advise you directions. 18:56:57 https://gitlab.com/fedora/docs/docs-website/ui-bundle/-/issues/6 18:58:06 yes, I made some space between the language button and the contributions buttons. I also changed the color of the buttons to the same color as the header background. These were the suggestions put up by Peter Boy. 18:58:06 The commit was included in the MR 18:58:17 ok was the commit added to the MR about scrollbar? 18:58:25 yes 18:58:47 i see. it's all applied? 18:59:11 Yes changes are a part of live site. 18:59:40 oh sorry, I wasn't too attentive to details. Thank you for your support. 18:59:52 No problem 19:00:01 could we move on to the next? 19:01:10 #info Flock Call for Proposal 19:01:38 ok. I don't knwo much about this area 19:02:34 Peter Boy submitted call for proposal to host interactive workshop in Flock. Peter and I worked on the abstract and program overview. 19:03:30 We are waiting for the proposal to be accepted. I can't go, but will work with Peter and others to prep workshop. 19:04:21 the title of CfP is Fedora Docs – Share Your Knowledge and Experiences Made Easy (and Fun). 19:04:22 Yeah I can't go either. Is the proposal and abstract online so I can see it? 19:05:14 ChristopherBush[: not yet. Once CfP is approved by reviewer committee, they will work on program details and make it public on Flock website. 19:05:24 oh ok 19:06:15 could we move on to next topic? 19:06:26 sure 19:06:36 #info Quick Docs Improvement 19:08:33 Metadata of Quick Docs needs bulk update before any other improvements are made. I'm in touch with experienced colleagues to write script. 19:09:20 https://discussion.fedoraproject.org/t/mass-update-of-docs-metadata/84413 19:10:44 I'm learning by doing although it is really slow. 19:11:11 any questions or suggestions? 19:13:21 Yeah I think the script would be your best bet. I can't think of a command that would work. But I am not very experienced in this sort of thing. 19:14:42 ok next one is 19:14:49 #info Role-based call to action: banner on Quick Docs home page 19:15:38 I have reminded all of on a thread opened in May - https://discussion.fedoraproject.org/t/documentation-landing-page-cta-call-to-action-your-feedback-is-important/81376 19:15:47 we could revisit in a few weeks time. 19:16:39 no rush 19:16:53 #info Review Docs hackfest 19:18:10 we need to wait for Justin and others who were involved Docs hackfest 2018-2020 before COVID. Many are on the road for events, so let's wait for them to come back. 19:18:36 That sounds good. 19:18:45 what I'm trying to do is monthly virtual 'write together' event. 19:19:02 That's an excellent idea. 19:19:12 I really like it. 19:19:53 Adding to our communication mix and more collaboration, I hope 19:20:21 That would also be extremely helpful in getting us newcomers up to speed. 19:21:51 ChristopherBush[: absolutely, I hope interactive session will help onboarding new colleagues and existing people who are interested in Docs. 19:22:48 #topic Open floor 19:24:36 I noticed when I took care of the two issues I did I really upended the workflow. So what I am going to work on this week is reading starting here: https://docs.fedoraproject.org/en-US/fedora-docs/ and learn the agreed upon workflow, and work on asciidoc and Antora. 19:25:18 I mean if I am going to work on the docs, I should probably read the docs lol 19:25:41 ChristopherBush[: that's good. I started reading it before I got tasks from Peter in June 2022. 19:26:12 ChristopherBush[: I like that. You are a good candidate for documentarian and more 19:27:35 ChristopherBush[: I amended contributor guides. If you find idiosyncrasies or something to improve, please make suggestions. 19:27:46 I sure will 19:29:32 I'll be away for holiday next week and until 7 July due to house move and holiday in Spain. 19:29:57 ok, will there be a meeting? 19:30:48 Peter is the chair usually and he will run it. 19:30:59 Oh ok 19:31:35 thanks for coming and your first contributions! 19:31:38 #endmeeting