19:30:19 <darknao> #startmeeting docs
19:30:19 <zodbot> Meeting started Wed Jan 11 19:30:19 2023 UTC.
19:30:19 <zodbot> This meeting is logged and archived in a public location.
19:30:19 <zodbot> The chair is darknao. Information about MeetBot at https://fedoraproject.org/wiki/Zodbot#Meeting_Functions.
19:30:19 <zodbot> Useful Commands: #action #agreed #halp #info #idea #link #topic.
19:30:19 <zodbot> The meeting name has been set to 'docs'
19:30:32 <darknao> #topic Roll call
19:30:34 <darknao> #chair pboy darknao pbokoc py0xc3[m]
19:30:34 <zodbot> Current chairs: darknao pbokoc pboy py0xc3[m]
19:30:41 <darknao> .hi
19:30:42 <zodbot> darknao: darknao 'Francois Andrieu' <darknao@drkn.ninja>
19:30:52 <pboy> .hi
19:30:53 <zodbot> pboy: pboy 'Peter Boy' <pboy@uni-bremen.de>
19:30:56 <hankuoffroad[m]> .hello hankuoffroad
19:30:57 <zodbot> hankuoffroad[m]: hankuoffroad 'None' <allegrovelo@gmail.com>
19:31:01 <AlanBowman[m]> .hi
19:31:02 <zodbot> AlanBowman[m]: Sorry, but user 'AlanBowman [m]' does not exist
19:31:08 <copperi[m]> .hello copperi
19:31:09 <zodbot> copperi[m]: copperi 'Jan Kuparinen' <copper_fin@hotmail.com>
19:31:21 <AnthonyMcGlone[m> Hi
19:33:19 <darknao> alright, let's start
19:33:33 <darknao> #topic Agenda
19:33:42 <darknao> #link https://discussion.fedoraproject.org/t/docs-meeting-agenda-2023-01-11/45734
19:33:44 <darknao> #info Announcements
19:33:46 <darknao> #info Tickets review
19:33:48 <darknao> #info Quick docs update
19:33:50 <darknao> #info Open Floor
19:33:52 <darknao> #topic Announcements
19:33:59 <darknao> #info Old Fedora docs (anything older than F26) have been retired.
19:34:01 <darknao> #info Beta version of the category system for Quick Docs has been deployed on stg
19:34:03 <darknao> #link https://docs.stg.fedoraproject.org/en-US/quick-docs/categories/administration/
19:34:05 <darknao> #info Next milestone is F38 (2023-04-18)
19:34:07 <darknao> #info We use GitLab to track work: https://gitlab.com/groups/fedora/docs/-/boards
19:34:09 <darknao> #info Vote for an alternate meeting time for 2023 is open!
19:34:11 <darknao> #link https://whenisgood.net/k7wa88t
19:34:47 <darknao> please take the time to vote here ^^
19:35:07 <pboy> already done
19:35:20 <AlanBowman[m]> Voted.
19:35:37 <darknao> great thanks!
19:35:43 <darknao> #topic Tickets review
19:36:00 <darknao> #link https://gitlab.com/groups/fedora/docs/-/issues/?label_name%5B%5D=Meeting
19:36:26 <darknao> So we have 6 tickets that require updates
19:36:38 <darknao> let's start with the older ones
19:36:50 <pboy> 3 tickets are about (old) Administrators Guide
19:36:54 <darknao> #link https://gitlab.com/fedora/docs/community-tools/fedora-accounts-docs/-/issues/9
19:37:06 <pboy> We may discuss them together?
19:37:29 <pboy> OK, let'sa sgtart with #9
19:37:47 <darknao> pboy: we will go over them one by one, then group if neededw
19:37:54 <pboy> OK
19:38:05 <darknao> so this one is about the Fedora Accounts documentation
19:38:12 <darknao> this is out of our scope
19:38:22 <darknao> so I'd say just leave it here
19:38:42 <pboy> Just leave it may not be the best solution.
19:39:39 <darknao> well, I think we have enough on our plate already to not care about tickets from other repos/teams
19:40:01 <pboy> Agreed.
19:40:09 <darknao> but if you want to take care of it, then you're more than welcome
19:40:32 <pboy> I already have enough on my plate. :-)
19:40:54 <pboy> Maybe, we should contact infra?
19:41:07 <pboy> Or who else is respnisble for it?
19:42:18 <darknao> yes, maybe infra would know who is responsible for it
19:42:24 <hankuoffroad[m]> pboy: yes, possibly who knows about identity management
19:43:10 <pboy> It's not just about identity managemant. Is's bout the complete account system
19:44:00 <pboy> OK. I'll contact infra.
19:44:21 <darknao> thanks!
19:44:40 <darknao> next ticket
19:44:45 <pboy> #action pboy will contact infra about the Fedora account documentation repo.
19:44:54 <darknao> #link https://gitlab.com/fedora/docs/fedora-linux-documentation/fedora-linux-sysadmin-guide/-/issues/3
19:45:27 <darknao> this one is about the sysadmin guide, we have a few others about it
19:45:57 <pboy> Yes, #4 and #5
19:46:16 <darknao> so I guess the first question is: what are our plans about the sysadmin guide?
19:46:40 <pboy> I think, 4 alternatives :
19:46:50 <pboy> 1. Fix the issues, just in case we might take it over to a followup version either in tools-box or in QuickDocs
19:47:00 <pboy> 2. Don't touch the old Guide and thus discard the tickets
19:47:11 <pboy> 3. Start to transfer the affected parts to either a new tool-box guide
19:47:21 <pboy> 4. Just postpone the tickets until we launch one of the successors
19:47:31 <pboy> I would like to avoid long list of unfinisched work in a repository we use for daily work.
19:47:39 <pboy> But I would like not to waste any community effort.
19:47:55 <pboy> A bit of a quandry
19:49:36 <darknao> I think I prefer 3. We salvage any useful articles from this guide (if any) for our new tool-box guide
19:50:38 <pboy> Thats not a really quick solution :-)
19:51:23 <darknao> if the ticket is about a minor fix, then we can just fix it and keep the page for the new guide, and if it's something major (like if the article obsolete) we ditch it and use either something from quick-docs or start something from scratch
19:51:54 <pboy> Probably a combination of 3 and 4? Mark it as postponed with the goal to transfer it to a successor?
19:52:41 <darknao> works for me
19:52:50 <hankuoffroad[m]> What is new tool-box guide?
19:52:58 <pboy> darknao: 2 are quick fix I thine. If we can easily remove the index line.
19:53:55 <pboy> hankuoffroad[m] That refers to the tools box at the docs home page. There we announce new or renewed admin tools guides.
19:54:02 <darknao> in this very specific case, the ntpd page is outdated, and the prefered way is to use chronyd anyway, so I'd say we ditch this one
19:54:14 <pboy> #link https://docs.fedoraproject.org/en-US/tools/
19:56:19 <pboy> OK. dirch #3, fix #5, postpone #4 ?
19:57:28 <darknao> ok so we are moving to the two other then
19:57:35 <darknao> #link https://gitlab.com/fedora/docs/fedora-linux-documentation/fedora-linux-sysadmin-guide/-/issues/4
19:58:03 <pboy> No so quick, who does the work on that 3?
19:59:04 <pboy> #4 is is more complex. At least not an easy fix.
19:59:30 <pboy> therefore: postpone and a link to the QuickDoc article?
20:00:24 <darknao> unless someone here want to work on #3, we can leave a comment saying that we are going to delete the page, and if someone has the time, they can work on that?
20:01:39 <pboy> darknao agreed, a kind of proviso.
20:02:11 <darknao> about #4, which is about Grub2, you mentioned we have an updated guide on quick docs?
20:02:34 <pboy> Yes, kind of.
20:02:52 <darknao> can we use the one from quick docs as a replacement?
20:03:03 <darknao> and remove this one?
20:03:21 <pboy> Hey are too different.
20:03:30 <pboy> I'm just looking for the link
20:03:53 <darknao> https://docs.fedoraproject.org/en-US/quick-docs/bootloading-with-grub2/ ?
20:03:53 <AnthonyMcGlone[m> https://docs.fedoraproject.org/en-US/quick-docs/bootloading-with-grub2/
20:04:14 <pboy> Yes, and Antnony is working on it.
20:05:02 <AnthonyMcGlone[m> I've only edited 2 of the sections. There's 9 left, including the one I am working on this week. There's a fair bit of work in it.
20:05:19 <AnthonyMcGlone[m> Here's the system admin guide for grub: https://docs.fedoraproject.org/en-US/fedora/latest/system-administrators-guide/kernel-module-driver-configuration/Working_with_the_GRUB_2_Boot_Loader/
20:06:31 <AnthonyMcGlone[m> The sections I edited where related to recovering the bootloader using a Live USB and using the grub prompt. Both of those aren't in the System Admin Guide as far as I can tell.
20:06:55 <AnthonyMcGlone[m> s/where/were/
20:07:15 <darknao> is there any benefits to keep 2 separate pages about Grub here?
20:07:50 <pboy> darknao In the long term we should integrate them.
20:08:23 <pboy> The QuickDoc article is quite long, too. We might shift it to the admin tools box.
20:08:52 <pboy> But that will take several months to implement.
20:08:58 <darknao> so in the long term the one in quick docs will be the final version (then moved to the tool box) right?
20:09:32 <pboy> darkno. I think so, maybe with some additional parts of the current admin guide page.
20:09:56 <darknao> in that case, we don't fix the one in sysadmin guide, say that we are currently working on the new one in quick docs, and close the ticket
20:10:14 <pboy> darknao agreed
20:10:21 <AnthonyMcGlone[m> +1
20:10:38 <pboy> And we should add a note at the top of the admin aricle?
20:11:31 <darknao> why not, with a link to the quick docs page?
20:11:48 <pboy> Yes, let's do so.
20:12:23 <darknao> alright
20:12:26 <pboy> Similar provise at the first page of the admin guide.
20:13:04 <darknao> we have 15 minutes left, should we leave it here for this topic and move to the Quick Docs update?
20:13:25 <pboy> We may postpone quickdoc to next meeting
20:13:42 <darknao> if that's ok for everyone
20:14:51 <darknao> I take that as a yes
20:15:06 <darknao> so we continue with the remaining tickets
20:15:23 <darknao> #link https://gitlab.com/fedora/docs/fedora-linux-documentation/fedora-linux-sysadmin-guide/-/issues/5
20:15:43 <darknao> ok so this one seems easy to me
20:16:11 <pboy> Yes, if we can just remove the indexterm:[HTTP  ...  line
20:16:30 <darknao> there is an indexterm attribute that has nothing to do here as it's not used by Antora system (I think that come from the previous documentation toolchain that we used)
20:16:56 <darknao> so yeah, we just need to remove the line
20:17:11 <pboy> agreed then
20:17:21 <pboy> Who is doing what ?
20:17:38 <pboy> regarding #3, #4, #5
20:18:40 <pboy> OK it's about about content, so you can action me
20:18:45 <pboy> :-)
20:20:19 <darknao> I don't think we need to action anyone right now for those. We now know what are the plans, we can just write it in each ticket, and if someone want to work on it, they can just assign them the ticket
20:21:05 <pboy> darknao we have to modify the text (adding a note, e.g.) and modify the ticket.
20:21:15 <darknao> it's also an easy way for new contributors to get involved as most of those actions are easy to do
20:22:12 <darknao> alright, let's do this now
20:22:17 <hankuoffroad[m]> darknao: sounds good
20:22:38 <darknao> for #3, we said that we are going to remove the page, right?
20:23:10 <pboy> yes
20:23:25 <pboy> just remove from nav.adoc
20:24:04 <AnthonyMcGlone[m> I can do it.
20:24:11 <pboy> +1
20:25:08 <darknao> done
20:25:10 <darknao> next
20:26:00 <pboy> #4, add a note with a link to the quick doc article and a planned successor
20:26:03 <darknao> #4: flag this page as obsolete with a link to the new one in quick docs, is that ok?
20:26:13 <pboy> yes
20:29:21 <darknao> then #5
20:29:33 <darknao> remove the line
20:29:44 <pboy> yes.
20:30:42 <darknao> and done
20:31:46 <pboy> good!
20:31:52 <pboy> And time is up now.
20:32:08 <darknao> yes, thanks everyone!
20:32:30 <darknao> everyone have a nice day and see you all next week
20:32:40 <pboy> b<e b<e
20:32:41 <hankuoffroad[m]> cheers
20:32:51 <darknao> #endmeeting