18:30:10 #startmeeting docs 18:30:10 Meeting started Wed Oct 25 18:30:10 2023 UTC. 18:30:10 This meeting is logged and archived in a public location. 18:30:10 The chair is pboy. Information about MeetBot at https://fedoraproject.org/wiki/Zodbot#Meeting_Functions. 18:30:10 Useful Commands: #action #agreed #halp #info #idea #link #topic. 18:30:10 The meeting name has been set to 'docs' 18:30:21 The object today is to provide an opportunity to discuss some current issues directly, quasi virtually vis-a-vis 18:30:21 Therefore, let's see who is here. 18:30:31 #topic Roll call 18:30:42 Please, everybody who is lurking, say either ".hello2" or ".hello " 18:30:43 .hello klavier 18:30:44 hkl: klavier 'Test Lab' 18:30:52 hi all 18:31:08 Hi Hank! 18:31:27 how are you? 18:31:53 I need your understanding today. I have to go out in 30 min for family. 18:32:00 Was a nice day. And I was able to a lot about my backlog 18:32:21 Sounds good 18:32:46 Yeah, it is very reassuring when the mountain becomes smaller. 18:33:03 Meaning your backlog as hybrid IT :) 18:33:19 :-) 18:34:19 my day was productiive too. I feel like achieving something against the all odds 18:34:54 it is thrilling to beat sceptics at work 18:35:36 It's a good feeling when one actually has the feeling of having accomplished something in the evening. 18:35:49 I mised that for quite a time 18:36:23 and an ever growing mountain in front 18:36:36 I think we can start now. 18:36:41 yes 18:36:48 #topic Agenda 18:36:56 #info Writing together virtually 18:37:04 #info Current state of Quick Docs issues and PRs 18:37:14 #info Current state of Docs Team tickets and PRs 18:37:25 #info Open floor 18:37:40 Anything to add? 18:37:48 no, all good 18:38:00 #topic 1. Writing together virtually 18:38:09 #link https://discussion.fedoraproject.org/t/write-together-virtually/82564/17 18:38:22 Tomorrow we have the next session. 18:38:39 Anything to discuss about it? 18:38:58 https://discussion.fedoraproject.org/t/82564/18 18:39:16 this link reflects time for 26 October 18:40:16 Yes, I read this, too. I'll have a prominent participant :-) 18:40:47 it is posted to social media and a couple of technical writer communities. also thanks to Alan Bowman, he reposted to Reddit. 18:41:11 I check JJitzi yesterday and could configurfe the permissions with my browser 18:41:13 I have a question on the demo - how to use Pagure for PR 18:41:27 OK, go on 18:41:29 That's good to hear 18:42:16 you and I need to deliver one method to create PR using web browser, right? it is regardless of each other's preference. 18:42:25 we can't confuse new people 18:43:19 https://docs.fedoraproject.org/en-US/fedora-docs/contributing-docs/contrib-quickdocs/ 18:43:21 Yes, but in this case we use the Pagure WEB interface to (automatically) create a fork and at the end a PR 18:43:36 cool. simple is best 18:44:08 I would like to demonstrate the same steps as I did at FLOCK. 18:44:14 It means: 18:44:15 and one contentious topic that always comes up is GitLab. 18:44:51 you first 18:44:55 I would start with an QD article and go from reading an article to work on it. 18:45:25 And probably ask participants to choose another one to follow the steps. 18:45:47 ++ 18:46:36 Yes, I hope, that will workl. At FLOCK it did. 18:47:19 According to the plan we'll have about 40 Mins for it. Isn't it? 18:47:21 ok I'll be excited to how you do it :) 18:47:46 yeah let's plan 40 min for interactive writing session 18:48:05 that leaves 10 min to share the result and go for Q&A 18:49:00 Yeah, maybe we need just 30 min, depends how quick we are selecting an article. 18:49:13 And I'm curious to see how well it works with the back and forth with screensharing. 18:49:21 So it is really interacrtive. 18:49:42 you can test it on your own with the second monitor 18:49:53 Yes, I did that. 18:50:12 sorted awesome 18:50:13 It is a little chubby 18:50:26 And a lot of work with the mouse 18:50:49 well enterprise video call disappoint me every day. Jitsi is awesome 18:50:51 chubby -> fiddly 18:51:01 i got it:) 18:51:26 Well, and what about gitlab? 18:51:33 luckily I can stay a bit more here. My daughter didn't take the train home yet. 18:51:47 that's good! 18:52:54 I mean, what topic comes up with Gitlab? 18:52:55 ah, GitLab thing often start like this: a versus b. why moving? It will confuse new people. 18:53:20 Yes, it is an issue. 18:53:47 that happened last time again. 18:53:58 I noticed that Gitlab change the GUI again. I think, it is a bit betterm now. 18:54:30 Yeah, we can't do a lot, at the moment, I suppose. 18:54:34 we just need them to focus on the learning experience on the session Not time to debate which tool is best 18:54:46 The migration is discussed in several threads. 18:54:56 Or the non-migration. 18:55:26 If I get it right, the migration is more or less stalled, until various issues are resoveld 18:55:33 oh no. I can't follow the pace of change at GitLab. Anyhow, all user docs are either in Pagure or GitHub. 18:56:18 i didn't know that. Migration of which repo? RelNotes? 18:57:15 No specific repo. but the "official" announcement, that Gitlab is the authoritative Fedora medium or tool. 18:57:35 i think it iis not helping if a group suggest a change of tool, and they are not invovled with the docs day to day work. it is contradiction 18:58:12 Pagure is the Fedora-maintained Git forge. Why favor GitLab? 18:58:13 Yes, indeed. That's really bad. 18:58:38 Same is true with the Antora CMS. 18:58:40 i have many things to do without GitLab. 18:59:00 But we have to somehow cope with it at the moment. 18:59:11 Antora CMS is only for the skin of web pages, not user documentation. 18:59:36 yes mostly around docs build and UX 18:59:36 Yes, but we have to use it and to resolve various issues and questions. 19:00:02 migration for that respect is already completed 19:00:15 i mean repo 19:00:32 Yes, it is. 19:01:14 We mave to find someone who will continously participat in docs work and specializes on Antora 19:01:53 i want to learn Antora thing, but maybe later next year. We need someone who is specialist 19:02:20 I can see a few names who already contributed to UX. 19:03:21 Yes, hopefully we can keep them motivated. 19:03:36 or better grow motivation. 19:03:39 ++ 19:03:52 Yes, at the moment we are very limited with the design and layout of the articles. 19:04:16 let's know about people who come to workshop. 19:04:51 Well. do we have an idea who will come? 19:05:15 enthusiastic new documentarians !! 19:05:51 Yeah, currently er are living from enthusiastic :-) 19:06:05 Justin Flory will join, too. Few people from technical review group in Reddiit and Linked wiill join 19:06:32 Oh, that looks like a lot of progress. 19:06:43 i also joined Write The Docs group for a chat 19:06:49 progress in terms of number of participants 19:07:16 i'm pretty sure we will see more people than previous time 19:07:19 You mean that group whoi is meeting in Australia and that Matthew mentions? 19:07:51 yes that organization. 19:08:01 btw, i need to leave in 2 min 19:08:07 soorry 19:08:24 i think my daugher took ICE from LONDON 19:09:00 OK, to I think, we should close now. I'm in the process of writing some Server doc. 19:09:08 Reddit and Linkedin group are much bigger than WTD matthew mentioned 19:09:25 that'll do. time to focus on that 19:09:39 see you tomorrow 19:09:54 thanks and bye 19:10:01 Yeah, see you (literally) tomorrow 19:10:06 Bye Byw 19:11:17 #topic 4. Open floor 19:11:26 I'll leave the channel open until the regular end in case anyone else has a question or concern. 19:11:37 So, I'm listening ... 19:24:05 back 19:29:05 Oh, I was playing around with my system configuration and could get to my 3rd monitor showing IRC for some time :-) 19:29:17 could not get _) 19:29:51 Welll, time is up now. So it's tomorrow. Looking forward to our meeting. 19:30:11 #endmeeting