18:30:40 #startmeeting docs 18:30:40 Meeting started Wed Apr 5 18:30:40 2023 UTC. 18:30:40 This meeting is logged and archived in a public location. 18:30:40 The chair is darknao. Information about MeetBot at https://fedoraproject.org/wiki/Zodbot#Meeting_Functions. 18:30:40 Useful Commands: #action #agreed #halp #info #idea #link #topic. 18:30:40 The meeting name has been set to 'docs' 18:30:46 #topic Roll call 18:30:48 #chair pboy darknao pbokoc py0xc3[m] 18:30:48 Current chairs: darknao pbokoc pboy py0xc3[m] 18:31:02 .hi 18:31:03 pboy: pboy 'Peter Boy' 18:31:26 hey everyone 18:31:27 .hello hankuoffroad 18:31:28 hankuoffroadPTO2: hankuoffroad 'None' 18:32:21 hi 18:34:01 #topic Agenda 18:34:06 #link https://discussion.fedoraproject.org/t/docs-meeting-agenda-2023-04-05/80491 18:34:08 #info Announcements 18:34:11 #info Global ticket review 18:34:13 #info Quick docs update 18:34:15 #info Open Floor 18:34:58 I've seen your post hankuoffroadPTO2, we can review that topic in Open Floor. Is that ok? 18:35:06 sure 18:35:10 great 18:35:30 #topic Announcements 18:35:34 #info F38 Final freeze is underway 18:35:37 #info F38 target date is in 2 weeks (2023-04-18) 18:35:39 #info We use GitLab to track work: https://gitlab.com/groups/fedora/docs/-/boards 18:35:48 anything to add to that list? 18:36:28 alright, moving on then 18:36:38 #topic Global ticket review 18:36:46 #link https://gitlab.com/groups/fedora/docs/-/issues/?sort=created_asc&state=opened&first_page_size=20 18:36:51 so, let's see... 18:37:13 #link https://gitlab.com/fedora/docs/fedora-linux-documentation/fedora-linux-sysadmin-guide/-/issues/8 18:37:32 that doesn't seems to be related to doc 18:37:51 and pboy, you already answered here 18:37:56 so I think we can just close it 18:38:05 agree? 18:38:20 agreed 18:38:41 yes 18:38:50 cool 18:38:53 next one 18:38:56 #link https://gitlab.com/fedora/docs/community-tools/documentation-contributors-guide/-/issues/21 18:38:57 Oh, we both closed it at the same time. you won. :-) 18:39:07 ahah :) 18:39:32 hankuoffroadPTO2: you are working on that one it seems? 18:39:42 darknao: I self-assigned me 18:39:53 It's an important issue, IMHO 18:40:01 ok, so I will flag it as "in progress" 18:40:09 darknao: yes I aim to share a draft in next weeks. 18:40:25 good 18:40:32 darknao: yes 18:41:05 is there anything you need from us? 18:42:18 darknao: maybe in next two weeks, I'll post a skeleton version with bullets so you can understand where I'm coming from and easier for contributors to use it as a signpost. 18:42:41 darknao: no, not now. I'm busy with video tutorial 18:42:46 ok, let us know if you need anything 18:42:57 darknao: thanks 18:42:58 next one is 18:43:04 #link https://gitlab.com/fedora/docs/docs-website/ui-bundle/-/issues/7 18:44:06 I think the problem is quite well described here, should be easy to fix I think 18:44:15 In general, I think it works. And other task are more important. 18:44:38 sure 18:44:55 flagged as `good first issue` and `minor change` 18:44:59 i had that impression that too - I missed scroll bar sometimes 18:45:03 +1 18:45:18 #link https://gitlab.com/fedora/docs/docs-website/pages/-/issues/21 18:45:21 hmmm 18:45:25 well, spam 18:45:39 oh dear 18:45:55 Hos is that posible? 18:46:20 can you delete it? 18:46:31 not just close 18:46:32 there is an option to report abuse to administrator, so I think it will block the user 18:46:47 reported, and closed 18:47:19 and that's all for tickets 18:47:34 let's take a quick look at MRs 18:47:38 are the users not linked to FAS prone to spammer? 18:48:01 #link https://gitlab.com/groups/fedora/docs/-/merge_requests 18:48:11 I don't think you need a fas account to create issue here 18:48:43 darknao: understood 18:48:54 #link https://gitlab.com/fedora/docs/docs-website/ui-bundle/-/merge_requests/6 18:50:09 it seems well-spotted for rendering issue 18:50:47 It looks nice and useful. 18:50:48 Not sure I understand what is described in this ticket, but the changes seems ok 18:51:47 a before/after would have been helpful I guess 18:51:51 It is a horizontral description list instead of the description nex line/paragraph. 18:52:50 anyway, seems good to me 18:52:55 agree to merge? 18:53:03 yes 18:53:08 +1 18:53:10 darknao: that's reasonable to follow the practice. well noted. 18:53:20 And add to our doku! 18:53:43 pboy: you mean contributor guide?? 18:53:51 Yes 18:53:59 asciidoc hints 18:54:07 no prob. Will do 18:54:14 +1! 18:55:10 pboy: especially helpful to demonstrate visual differences 18:55:24 yes, indeed 18:55:48 so that was the last PR to review, let's move to the next topic 18:56:03 #topic Quick docs update 18:56:13 anything on that front? 18:56:55 I contacted @t0xic0der directly regarding 571 and he had a look at it 18:57:03 no I haven't contributed to QuickDocs recently. Can't comment 18:57:53 I made some minor contributions, but couldn't systematize it. 18:58:09 Server F38 was too much work. 18:58:26 but now it is freeze. 18:58:42 So can can do more work with docs now 18:59:33 pboy: just nitpick, but posting terminal screen is bizarre 18:59:58 Yes it is. but nevertheless, sometimes helpfull 19:00:34 But it is much work in case of an update 19:00:41 if output is required, then text form is more than enough 19:01:20 Yesd, for users with some experience. For newbies? 19:02:18 pboy: it depends :) 19:02:35 :-) 19:04:44 ok anything else or should we move to open floor? 19:04:58 nothing from me 19:04:58 no from me 19:05:06 ok, open floor it is 19:05:08 #topic Open Floor 19:05:43 cool 19:05:54 https://gitlab.com/fedora/docs/community-tools/documentation-contributors-guide/-/snippets/2503787 19:06:32 it is a long document about the Web IDE tutorial in video version 19:08:34 At a first sight, I like it. 19:08:39 thanks for working on this hankuoffroadPTO2 19:08:59 hankuoffroad++ 19:08:59 darknao: Karma for hankuoffroad changed to 1 (for the current release cycle): https://badges.fedoraproject.org/tags/cookie/any 19:09:11 IT's long, but that is compensated by a good structure. 19:09:34 it was well worth my efforts, thanks. I'll recommend Web IDE to anyone now. 19:10:28 Screen recording is next. I have created PeerTube account in linux channel, so it is fully FOSS 19:11:14 Fully FOSS, very good! 19:11:22 pboy: because it is semi-video script (not even written in full sentence yet) so I can layer text onto screen 19:12:28 Yes, I see 19:12:48 Thanks for your guidance that helped me learn and do more. 19:13:42 Thank you, too, for all the progress we made, despite our small number of people. 19:14:15 I hope video can appeal to new generation of visual learners 19:14:42 the more people, the better the outcome will be 19:15:23 The other saying is : 19:15:30 Many cooks spoil the broth 19:15:39 pboy: darknao and other members made me stretch my comfort zone. 19:15:43 (or so) 19:16:06 pboy: ah that's another meaning in English 19:16:35 pboy: i take it as a joke with German twist :) 19:16:37 OK, my German background 19:17:00 hankuoffroadPTO2 yes, indead 19:17:04 indeed 19:18:06 hi catcream_ 19:19:15 that's all from me 19:19:51 Just a question: Does someone know about Flock 2023? 19:19:59 https://discussion.fedoraproject.org/t/fedora-council-tickets-ticket-426-flock-2023-finalize-dates-and-venue-for-our-next-in-person-contributor-conference/44620 19:20:14 oh it is going to be n Cork. I can't go 19:20:25 It it will happen, we should do something as docs team. 19:20:52 hankuoffroadPTO2 Another idea was Madring / Barcelona. 19:20:57 #link https://flocktofedora.org/ 19:21:06 i don't think streaming or virtual session will be done at the same time. it is fully in person event this time 19:21:10 we have the location and the date 19:22:50 Cork is Irish republic, isn't it? 19:23:06 my personal travel budget has stretched to the limit this year. yes Irelands 19:23:44 are you interested to join in person? 19:23:58 Yes, I am. 19:24:19 Budget is a problem, will see. 19:24:51 flight is cheap from UK, but hotel and everything else is not 19:25:27 Yeah, specifically "everything else" 19:25:55 pboy: just returned from Easter holiday (after 3 years of non travel) and will do another trip to Europe, But I'll do what I can support remotely 19:26:25 Good to know. 19:27:24 I think Docs need more online presence such as tutorial and Classroom session. Flocks agenda is heavily focused on other topics which are overcrowded. 19:28:42 well that's my view. 19:28:44 I agree. But additionally, we should promote the need for documentation among developers. 19:28:55 agree 19:30:07 pboy: true because our toolchain is same as deveopers 19:30:43 Yeah, that's one side of the coin. 19:31:03 alright, meeting is over, we are out of time. Thanks everyone for coming, see you all next week! 19:31:09 and happy easter :) 19:31:11 thanks 19:31:21 #endmeeting