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