19:31:00 <darknao> #startmeeting docs
19:31:00 <zodbot> Meeting started Wed Dec 28 19:31:00 2022 UTC.
19:31:00 <zodbot> This meeting is logged and archived in a public location.
19:31:00 <zodbot> The chair is darknao. Information about MeetBot at https://fedoraproject.org/wiki/Zodbot#Meeting_Functions.
19:31:00 <zodbot> Useful Commands: #action #agreed #halp #info #idea #link #topic.
19:31:00 <zodbot> The meeting name has been set to 'docs'
19:31:07 <darknao> #topic Roll call
19:31:13 <darknao> #chair pboy darknao pbokoc py0xc3[m]
19:31:13 <zodbot> Current chairs: darknao pbokoc pboy py0xc3[m]
19:31:20 <pboy> .hi
19:31:22 <zodbot> pboy: Something blew up, please try again
19:31:25 <zodbot> pboy: An error has occurred and has been logged. Please contact this bot's administrator for more information.
19:31:28 <darknao> hi o/
19:31:44 <pboy> .hello pboy
19:31:45 <zodbot> pboy: Something blew up, please try again
19:31:48 <zodbot> pboy: An error has occurred and has been logged. Please contact this bot's administrator for more information.
19:31:58 <pboy> hm, no luck today
19:32:17 <darknao> zodbot is on holiday :p
19:32:26 <pboy> nice
19:33:45 <darknao> so I'm not sure there will be many people today
19:33:46 <hankuoffroad[m]> .hello hankuoffroad
19:33:47 <zodbot> hankuoffroad[m]: Something blew up, please try again
19:33:50 <zodbot> hankuoffroad[m]: An error has occurred and has been logged. Please contact this bot's administrator for more information.
19:33:57 <hankuoffroad[m]> hi
19:34:05 <darknao> hey hankuoffroad[m]
19:34:58 <darknao> ok let's get started
19:35:08 <darknao> #topic Agenda
19:35:10 <darknao> #link https://discussion.fedoraproject.org/t/docs-meeting-agenda-2022-12-28/45240
19:35:12 <darknao> #info Announcements
19:35:14 <darknao> #info Quick docs update
19:35:16 <darknao> #info Open Floor
19:35:18 <darknao> #topic Announcements
19:35:24 <darknao> #info Old Fedora docs (anything older than F26) have been retired.
19:35:26 <darknao> #info Beta version of the category system for Quick Docs has been deployed on stg
19:35:28 <darknao> #link https://docs.stg.fedoraproject.org/en-US/quick-docs/categories/administration/
19:35:30 <darknao> #info Next milestone is F38 (2023-04-18)
19:35:32 <darknao> #info We use GitLab to track work: https://gitlab.com/groups/fedora/docs/-/boards
19:35:48 <darknao> anything else to announce?
19:37:06 <pboy> nope
19:37:08 <darknao> alright, next topic then
19:37:10 <darknao> #topic Quick docs update
19:37:21 <pboy> Well, that's me
19:37:27 <darknao> floor is yours
19:37:41 <pboy> Unfortunately, discussion is down just now.
19:37:51 <pboy> I wanted to discuss 2 threads .
19:38:03 <pboy> But we can discuss some issues, first.
19:38:13 <pboy> Write a better "installing software from source" quick-doc
19:38:24 <pboy> https://pagure.io/fedora-docs/quick-docs/issue/120
19:38:32 <pboy> What about my proposal (last comment)
19:38:57 <pboy> SORRY
19:39:02 <pboy> https://pagure.io/fedora-docs/quick-docs/issue/111
19:40:38 <darknao> is there a PR waiting for this?
19:40:55 <pboy> No, just the issue.
19:41:06 <pboy> I would do the editing.
19:42:03 <darknao> you are going to reuse ramin's work right?
19:42:31 <pboy> yes, as it is with just some formal adjustmends.
19:42:46 <darknao> ok, seems fine to me
19:42:53 <pboy> And I would take him as the author.
19:43:28 <pboy> hankuoffroad[m] What about you?
19:44:08 <hankuoffroad[m]> I presume those who need to install sotware from source are advanced users. It's beyond my toolbelt
19:45:16 <hankuoffroad[m]> I'll take a look at it and comment
19:45:25 <pboy> Yeah, what do you think about the proposal, to take and publish it as is (with just formal adjustments)
19:45:57 <pboy> And to add a editor's note.
19:47:37 <hankuoffroad[m]> pboy: I haven't looked at the commits by @ramin
19:48:05 <pboy> Ok, so what to do?
19:48:23 <pboy> Postpone to next meeting?
19:49:16 <hankuoffroad[m]> pboy: I think i'm not ready to comment on the docs for advanced users. Don't hold it for me.
19:50:14 <pboy> Ok, but you don't object to pick up the work and publish it?
19:50:31 <darknao> note that I didn't read it completly either, but the content seems to be a good base if someone advanced enough want to work on it in the future
19:50:55 <pboy> +1
19:51:11 <hankuoffroad[m]> pboy: I have no objection to it as the content was reviewed by several authors.
19:51:23 <pboy> Ok, so
19:51:31 <darknao> at least, it has way more chance to be improved if published as is, as if we leave it in ramin's fork and forget about it
19:51:53 <darknao> so +1 for me
19:51:55 <pboy> #agreed We publish the work or ramin  issue #111
19:52:11 <pboy> Next issue:
19:52:21 <pboy> 133: Adding (Debugging) info to Navigation tool
19:52:28 <pboy> https://pagure.io/fedora-docs/quick-docs/issue/133
19:52:35 <pboy> Proposal: Close a stale.
19:52:43 <pboy> as stale
19:53:57 <darknao> I guess the idea was to move wiki articles to Docs?
19:54:18 <pboy> I think so, yes.
19:54:43 <pboy> Many wiki articles had been transferred. These ones are obviously left.
19:55:29 <pboy> Alternativly, we can transferr them and add the proviso, some other articles still have.
19:55:37 <darknao> maybe we can keep it open if someone want to work on moving those pages?
19:57:05 <darknao> most of them are quite old so no sure how accurate they are right now
19:57:07 <pboy> May be, then is would be better to transfer them and add a disclaimer as in
19:57:15 <pboy> #link https://docs.fedoraproject.org/en-US/quick-docs/kernel/build-custom-kernel/
19:57:36 <pboy> Yes, the problem is, they are old, indeed.
19:58:37 <pboy> I'm afraid just leaving the ticket open won't bring any change for the next 2 years either.
20:01:36 <darknao> troubleshooting guides require quite extensive knowledge on the topic, so moving the wiki articles to docs is easy, but reviewing or fixing them, not so much
20:02:41 <pboy> Yes, it we transfer them, someone may read and do a review, hopefully.
20:03:38 <pboy> if we just leave the ticket open, nobody will find them and we better close it, I think.
20:03:43 <darknao> the stacktraces one has been modified in 2021, so it's not that old, and the content still seems relevant
20:04:15 <pboy> Good, I think then we should transfer it (I'm willing to do itI.
20:04:43 <darknao> +1
20:05:18 <pboy> Question with the others is, are we making fools of ourselves?
20:05:23 <hankuoffroad[m]> +1
20:06:12 <darknao> I think it'll get more visibility than on the wiki and maybe someone will get interested in reviewing it
20:06:47 <darknao> I also think we should only move the ones that are still relevant and not too old
20:06:59 <darknao> for instance, I would drop the xorg one
20:07:14 <darknao> same for Alsa
20:07:22 <hankuoffroad[m]> pboy: I don't think so. It is content reuse. All we need is subject matter expert for cusom kernel.
20:09:16 <darknao> all the others seem like valuable information to me
20:09:46 <hankuoffroad[m]> darknao: Sure
20:10:06 <pboy> OK, new proposal, we start to transfer, but w/o  xorg, Alsa
20:11:13 <darknao> +1
20:11:29 <pboy> #agreed issue #133: We start to transfer with wiki disclaimer w/o xorg and alsa
20:11:44 <pboy> Next one.
20:11:53 <pboy> #153 Request: using a Yubikey on Fedora
20:12:01 <pboy> https://pagure.io/fedora-docs/quick-docs/issue/153
20:12:10 <pboy> For 2 yeas noone worked on it. Not one line of text sofar.
20:12:20 <pboy> Proposal: close stale
20:15:06 <darknao> I think we should keep that one open
20:15:09 <hankuoffroad[m]> +1. until someone revives the topic.
20:15:47 <darknao> a page on how-to use yubikey with Fedora is very valuable, even if no one want to work on it at this time
20:16:28 <pboy> My concern is, just leaving it open will not lead to anything.
20:16:39 <darknao> closing it either :)
20:17:03 <pboy> Indeed, yes. :-) But OK, let's check it in 6 months again.
20:17:45 <darknao> also there is a wiki page here
20:17:46 <pboy> Well, I wanted to discuss 2 threads indiscussion. But it is not back again.
20:17:55 <darknao> that has been modified very recently
20:18:10 <pboy> Can you post a URL?
20:18:15 <darknao> so maybe we can just move it to Docs and see if that helps?
20:18:20 <darknao> https://fedoraproject.org/wiki/Using_Yubikeys_with_Fedora
20:18:28 <darknao> (it's in the issue)
20:19:11 <pboy> Oh, I overlooked that. Yes, I think we should transfer it.
20:20:17 <pboy> #agreed Regarding issue 153 we will transfer the wiki page at https://fedoraproject.org/wiki/Using_Yubikeys_with_Fedora
20:21:19 <pboy> That's it from me. My other topics need discussion which is still offline.
20:21:54 <darknao> ok, open floor then
20:22:02 <darknao> #topic Open Floor
20:22:52 <hankuoffroad[m]> I have a question on meeting time
20:23:28 <darknao> hankuoffroad[m]: sure, go ahead
20:24:14 <hankuoffroad[m]> We have new contributors working on different time zone.
20:24:46 <hankuoffroad[m]> Can we take a vote for alternative meeting time?
20:24:54 <darknao> I'm fine with that
20:25:17 <pboy> me too
20:25:22 <hankuoffroad[m]> The Fedora chat has been motivating me for more collaboration.
20:25:44 <darknao> can you create a topic on Discourse with multiple time slot to choose? or a WhenIsGood (even better)?
20:25:58 <hankuoffroad[m]> Sure, I'll do that
20:26:16 <darknao> thanks
20:26:17 <pboy> I think WhenIsGood is better. :-)
20:26:27 <pboy> more systematic
20:26:50 <hankuoffroad[m]> Should I copy the link to Discussion?
20:27:06 <pboy> yes!
20:27:07 <darknao> yep so everyone interrested can vote
20:27:21 <pboy> You should open a thread about it nevertheless.
20:27:46 <hankuoffroad[m]> That works for me. Will check in later and open the thread
20:28:47 <pboy> You should wait until next year, when everyone is back, I think.
20:29:04 <pboy> it means: end of next week.
20:29:18 <hankuoffroad[m]> Yeah fair enough, forgot
20:30:00 <darknao> we can keep it open for 2-3 weeks to make sure everyone has time to vote
20:30:34 <darknao> alright, time is up
20:30:47 <pboy> Yes, but the thread should not be done now, when it is forgotten, when everyone is back.
20:31:08 <darknao> thanks everyone, and see you all next year!
20:31:14 <darknao> +1 pboy
20:31:27 <hankuoffroad[m]> +1
20:31:44 <darknao> #endmeeting