18:31:11 #startmeeting Fedora/CentOS Docs meeting 18:31:11 Meeting started Wed Mar 23 18:31:11 2022 UTC. 18:31:11 This meeting is logged and archived in a public location. 18:31:11 The chair is darknao. Information about MeetBot at https://fedoraproject.org/wiki/Zodbot#Meeting_Functions. 18:31:11 Useful Commands: #action #agreed #halp #info #idea #link #topic. 18:31:11 The meeting name has been set to 'fedora/centos_docs_meeting' 18:31:18 #chair bcotton pboy mroche darknao pbokoc py0xc3 18:31:18 Current chairs: bcotton darknao mroche pbokoc pboy py0xc3 18:31:25 #topic Agenda & Roll call 18:31:30 .heelo2 18:31:32 .hi 18:31:33 darknao: darknao 'Francois Andrieu' 18:31:34 .hello2 18:31:36 pboy: pboy 'Peter Boy' 18:31:40 .hi 18:31:41 shaunm[m]: Sorry, but user 'shaunm [m]' does not exist 18:31:51 grr 18:31:52 .hello shaunm 18:31:54 shaunm[m]: shaunm 'Shaun McCance' 18:32:10 some day I'll learn all the zodbot commands correctly 18:34:13 ok let's start 18:34:20 Today's agenda is available at 18:34:22 #link https://discussion.fedoraproject.org/t/docs-meeting-agenda-2022-03-23/37737 18:34:28 #topic Announcements 18:34:36 #info F36 Beta is NO-GO 18:34:38 #info Go/No-Go meeting is this thursday (2022-03-24 17:00 UTC) 18:35:20 do you have any news to share? 18:36:04 alright, moving on 18:36:14 #topic Previous action items 18:36:50 bcotton was to comment on https://pagure.io/fedora-docs/pages/pull-request/23 and suggest split of user and WG docs to IoT 18:37:03 seems like both are done 18:37:15 #info bcotton was to comment on https://pagure.io/fedora-docs/pages/pull-request/23: Done 18:37:17 #info bcotton was to suggest split of user and WG docs to IoT: Done 18:37:31 #info bcotton was to prepare an Outreachy proposal for docs content curation improvement: Done 18:37:36 #link https://hackmd.io/3gu_MzPNR-G9T8lMPsWNww 18:37:51 #info darknao was to work with Fedora Infrastructure to get permissions setup on the GitLab workspace: In Progress 18:37:58 #link https://pagure.io/fedora-infrastructure/issue/10604 18:38:45 I'll provide updates at next meeting, if I have any 18:38:45 I commited to work on a PoC about new installation guid(e). I'm in the process od doing it. 18:38:56 #action darknao to provide updates on permissions setup for GitLab space 18:39:59 pboy: ok, i'm adding it back to the action plan then 18:40:12 Does the Outreachy application have a deadline that we are in danger of missing due to Ben's absence? 18:40:12 #action pboy to start a PoC of the new content plan with the Installation Guide 18:40:20 I expect to complete it and of week. 18:40:26 this week. :-) 18:40:39 nice 18:41:22 shaunm[m]: not sure about any deadline 18:42:47 Not necessarily a deadline, but but insure work is in process 18:43:21 sorry, wrong reference 18:43:49 I see the proposal is already submitted here: https://pagure.io/mentored-projects/issue/128 18:44:10 so we are good 18:44:32 #topic docs-fp-o backlog refinement 18:44:40 #link https://pagure.io/fedora-docs/docs-fp-o/issues?status=Open&order_key=last_updated&order=asc 18:45:02 .showticket https://pagure.io/fedora-docs/docs-fp-o/issue/%s 30 18:45:05 darknao: Issue #30: Relocate all old docs repos into the Fedora-docs name space and mark them deprecated - docs-fp-o - Pagure.io - https://pagure.io/fedora-docs/docs-fp-o/issue/30 18:46:06 not sure what are these old docs repos, the only one I know is https://pagure.io/fedora-docs-web 18:47:01 Probably Fedora 25 and earlier? 18:47:12 and is this really relevant now that we are going to drop old docs? 18:47:42 I don't think, it is relevant to drop / delete them. Is someone working on it? 18:48:14 we have another ticket about this: https://pagure.io/fedora-docs/docs-fp-o/issue/183 18:48:49 Yes, we should close #30 as replaced / succeeded by 183 18:51:07 #info #30 Relocate all old docs repos into the Fedora-docs name space and mark them deprecated: superseded by #183 18:51:19 .showticket https://pagure.io/fedora-docs/docs-fp-o/issue/%s 40 18:51:20 darknao: Issue #40: Revision History - docs-fp-o - Pagure.io - https://pagure.io/fedora-docs/docs-fp-o/issue/40 18:52:23 I think this one refer to the old docs only, and is not really relevant to the new antora one 18:52:36 Proposal: Close because outdated by the development of a new structure. 18:52:46 agree 18:53:14 +1 18:53:22 +1 18:54:02 #info #40 Revision History: close as outdated 18:54:13 .showticket https://pagure.io/fedora-docs/docs-fp-o/issue/%s 39 18:54:14 darknao: Issue #39: Explicitly mention the `-o` option to `grub2-mkconfig` - docs-fp-o - Pagure.io - https://pagure.io/fedora-docs/docs-fp-o/issue/39 18:54:24 Suggestion: close #39 because outdated by the development of a new structure. 18:54:54 Correctionm: without "by the development of a new structure" 18:54:55 is it? 18:55:47 I think it is outdated. Where do you want to mention what? 18:56:45 I think we need a new guide: typical problem solving or so 18:57:04 Maybe a section in quick doc 18:58:33 the initial issue is still present, the current doc doesn't mention anything about making backup of your grub.cfg before generating a new one 18:58:53 so I guess it's still valid 18:59:09 Can you say where you have looked? 19:00:39 in the administrator guide, but i looked at it really quickly... Are you saying it's mentioned now? I most likely missed it 19:00:42 https://docs.fedoraproject.org/en-US/fedora/f35/system-administrators-guide/kernel-module-driver-configuration/Working_with_the_GRUB_2_Boot_Loader/ 19:01:07 I think we are planning to rework the admin guide. 19:01:22 So maybe mark as deferred until the future structure is in place? 19:01:53 That sounds better 19:03:33 but issue is indeed valid still. 19:04:14 Yes, but we should spend work on the admin guide at the moment. 19:04:58 #info #39: updated, and mark as deferred until the future structure is in place 19:05:04 .showticket https://pagure.io/fedora-docs/docs-fp-o/issue/%s 44 19:05:07 should. -> should not 19:05:10 darknao: Issue #44: Clean up pass:attribute[{blank}] - docs-fp-o - Pagure.io - https://pagure.io/fedora-docs/docs-fp-o/issue/44 19:06:18 anyone know about this? I can't remember seeing this kind of attribute somewhere 19:07:11 I’ve to admit, I wrote a lot of docs recently, but don’t even know anything about that. 19:07:47 But seems to be a relevant topic for a writer#s guide or style guide. 19:09:43 ok, setting this a low priority for now 19:10:14 .showticket https://pagure.io/fedora-docs/docs-fp-o/issue/%s 52 19:10:14 darknao: Issue #52: epub and pdf files - docs-fp-o - Pagure.io - https://pagure.io/fedora-docs/docs-fp-o/issue/52 19:10:17 Won't you explicitly mention a style guide? 19:11:26 "Right now no one has stepped forward to code it." Did that change? 19:12:00 yeah the writer guide seems appropriate (for the last one) 19:12:31 so for that one, currently Antora doesn't allow it 19:12:54 but, they are working on a antora extension for that 19:13:21 Well, than we should deferr it until technically possible? 19:13:38 so we basically just have to wait until it's released 19:15:36 #info #52: epub and pdf files : antora extension is in development 19:15:46 .showticket https://pagure.io/fedora-docs/docs-fp-o/issue/%s 53 19:15:47 darknao: Issue #53: Docs on docs-old should have a banner pointing to new docs (where new docs exist) - docs-fp-o - Pagure.io - https://pagure.io/fedora-docs/docs-fp-o/issue/53 19:16:23 superseded by #183? 19:16:31 mmh, same as the other one: superseded by #183? 19:16:36 right :) 19:18:04 #info #53: banner on old-docs: superseded by #183 19:18:14 .showticket https://pagure.io/fedora-docs/docs-fp-o/issue/%s 64 19:18:15 darknao: Issue #64: URL for Modularity subdocument comes out wrong. - docs-fp-o - Pagure.io - https://pagure.io/fedora-docs/docs-fp-o/issue/64 19:18:37 #64 seems to be resolved? there is a redirection ? 19:19:07 yep, but it's still redirecting to Modularity instead of fesco 19:19:39 note that this temporary redirection is at least 4 years old, maybe we can simply remove it at this point? 19:20:33 Do you know, where to remove? 19:20:54 to remove any redirection would be best. 19:21:04 I think there is a repo somewhere with all the redirections 19:21:13 And who has permission to do so? 19:21:23 I just need to find it ^^ 19:21:36 OK, happy searching. :-) 19:21:57 ask bcotton :) 19:22:02 You should action yourself. :-) 19:22:20 #info #64: URL for Modularity subdocument comes out wrong : see if we should remove the outdated redirection instead 19:22:21 sorry, I mean darknao 19:22:56 #action darknao to find where the redirection is set up, and ask for removal 19:23:36 .showticket https://pagure.io/fedora-docs/docs-fp-o/issue/%s 65 19:23:37 darknao: Issue #65: Add release date to release notes - docs-fp-o - Pagure.io - https://pagure.io/fedora-docs/docs-fp-o/issue/65 19:24:00 I think this is still valid 19:25:13 maybe we can link it to https://pagure.io/fedora-docs/docs-fp-o/issue/22 too? 19:25:27 agree, who can do it, bcotton? 19:26:17 yeah I think so 19:26:39 We can action him, he is not online. :-) 19:26:55 or didn't join 19:27:10 #info #65 Add release date to release notes 19:27:36 #action bcotton to comment on #65 19:28:04 yeah, and #22 19:28:17 #undo 19:28:17 Removing item from minutes: ACTION by darknao at 19:27:36 : bcotton to comment on #65 19:28:21 #action bcotton to comment on #65 and #22 19:28:28 ok we are out of time 19:28:41 #info Open floor 19:28:44 Thanks 19:29:02 maybe one last thing about https://pagure.io/fedora-docs/docs-fp-o/issue/189 19:29:14 it's been 22 days now 19:29:45 I am not a member, where does one apply ? 19:29:54 maybe we can start the cleaning at the end of week? 19:30:23 Yeh, time to make a page in out docs, kind of member list? (and count me in, too) 19:30:36 out -> our 19:30:51 copperi[m]: you can directly comment on this ticket 19:31:03 yes, I will 19:31:05 I think I did 19:31:20 yes, you did 19:31:40 alright thanks everyone, this was a good run again. See you to the next one :) 19:31:48 #endmeeting