18:31:43 <darknao> #startmeeting docs
18:31:43 <zodbot> Meeting started Wed Mar 22 18:31:43 2023 UTC.
18:31:43 <zodbot> This meeting is logged and archived in a public location.
18:31:43 <zodbot> The chair is darknao. Information about MeetBot at https://fedoraproject.org/wiki/Zodbot#Meeting_Functions.
18:31:43 <zodbot> Useful Commands: #action #agreed #halp #info #idea #link #topic.
18:31:43 <zodbot> The meeting name has been set to 'docs'
18:31:50 <darknao> #topic Roll call
18:31:52 <darknao> #chair pboy darknao pbokoc py0xc3[m]
18:31:52 <zodbot> Current chairs: darknao pbokoc pboy py0xc3[m]
18:35:10 <darknao> seems like I'm going to be alone :/
18:39:01 <pboy> .hi
18:39:01 <zodbot> pboy: pboy 'Peter Boy' <pboy@uni-bremen.de>
18:39:27 <darknao> hi pboy
18:39:40 <pboy> Sorry, a bit lat today
18:40:16 <darknao> no problem
18:40:22 <darknao> let's start then
18:40:33 <darknao> #topic Agenda
18:40:39 <darknao> #link https://discussion.fedoraproject.org/t/docs-meeting-agenda-2023-03-22/79787
18:40:40 <darknao> #info Announcements
18:40:43 <darknao> #info Tickets flagged for meeting
18:40:45 <darknao> #info Global ticket review
18:40:47 <darknao> #info Quick docs update
18:40:49 <darknao> #info Open Floor
18:40:51 <darknao> #topic Announcements
18:40:55 <darknao> #info F38 is planned for next month (2023-04-18)
18:40:58 <darknao> #info We use GitLab to track work: https://gitlab.com/groups/fedora/docs/-/boards
18:41:40 <darknao> #info DST change warning: the meeting is now at 18:30 UTC (1 hour earlier)
18:41:48 <darknao> anything else?
18:42:04 <pboy> nope
18:42:13 <darknao> very well
18:42:19 <darknao> #topic Tickets flagged for meeting
18:42:29 <darknao> There is one item to review
18:42:42 <darknao> #link https://gitlab.com/fedora/docs/community-tools/documentation-contributors-guide/-/merge_requests/73
18:43:14 <pboy> reading ....
18:43:51 <darknao> #link https://fedora.gitlab.io/-/docs/community-tools/documentation-contributors-guide/-/jobs/3978045132/artifacts/public/fedora-docs/contributing-docs/tools-web-ide-ui.html
18:43:54 <darknao> for the preview
18:44:09 <pboy> thanks! (for URL preview)
18:45:14 <darknao> that looks nice
18:45:23 <darknao> +1 to merge
18:45:33 <pboy> Yes, looks weel done.
18:46:12 <pboy> s/weel/well
18:46:27 <pboy> Would you merge it?
18:46:30 <darknao> yer
18:46:32 <darknao> yes*
18:46:55 <darknao> done
18:46:59 <darknao> next topic
18:47:14 <darknao> #topic Global ticket review
18:47:34 <darknao> so, I wanted to do some global ticket review today, as we didn't do that in a long time
18:47:53 <darknao> and we have a few tickets that needs update I think
18:47:59 <pboy> Yes, we urgently have do do this
18:48:29 <darknao> #link https://gitlab.com/groups/fedora/docs/-/issues/?sort=updated_asc&state=opened&first_page_size=20
18:49:12 <darknao> #link https://gitlab.com/fedora/docs/docs-website/pages/-/issues/7
18:49:14 <darknao> first one
18:49:38 <pboy> Yes, the famous release notes
18:49:56 <darknao> we have a few tickets like this, I was wondering if we should close them once it's done, then recreate one for the next release
18:50:07 <darknao> or just rename this one and tag it for F39
18:50:24 <pboy> We should definitely close those that are done.yes
18:51:16 <darknao> alright
18:51:24 <pboy> What is the current status regarding release notes?
18:52:02 <darknao> this one is just about creating the branch, which is done
18:52:05 <darknao> so closing
18:52:22 <pboy> yes, same for the next issue, I think.
18:53:22 <darknao> what guide do we have left here?
18:53:30 <darknao> install guide is gone
18:53:37 <darknao> sysadmin-guide I think
18:53:40 <darknao> and that's it?
18:53:47 <pboy> what about the third, updates?
18:54:02 <darknao> hold on, I'm still on the second one
18:54:11 <darknao> #link https://gitlab.com/fedora/docs/docs-website/pages/-/issues/8
18:54:22 <pboy> OK
18:55:05 <pboy> I think there is nothing to branch, maybe the outdated admin guide, we still didn't fully replace yet.
18:55:22 <hankuoffroad[m]> .hello hankuoffroad
18:55:24 <zodbot> hankuoffroad[m]: hankuoffroad 'None' <allegrovelo@gmail.com>
18:55:37 <pboy> welcome hankuoffroad[m]
18:55:38 <hankuoffroad[m]> sorry, I'm late.
18:55:38 <darknao> hi hankuoffroad[m]
18:55:52 <darknao> pboy: yeah the sysadmin guide is the only one left
18:56:30 <darknao> #link https://gitlab.com/fedora/docs/docs-website/pages/-/issues/9
18:57:01 <darknao> don't know for this one, is there anything to update on this guide for release?
18:57:20 <pboy> I think, that is very specific to editions It is their task.
18:57:41 <pboy> I'm just writing a note for Server
18:58:05 <darknao> note this is for the guide we maintain, not the edition ones
18:58:12 <darknao> so basically, the sysadmin guide
18:58:25 <darknao> just like the previous ticket
18:58:46 <pboy> OK, but we don't maintain the admin guide anymore. But are to replace it.
18:59:09 <darknao> so nothing to update then
18:59:13 <darknao> that's fine for me
18:59:19 <pboy> We have to update our release page, og course.
18:59:29 <pboy> s/og/of
19:00:03 <pboy> But there is not much to update
19:01:02 <darknao> just to be sure, what release page are you reffering to?
19:01:45 <pboy> Our docs "release home page", wait ...
19:02:04 <pboy> #link https://docs.fedoraproject.org/en-US/fedora/latest/
19:02:33 <pboy> that one.
19:02:53 <pboy> How will we do the update? (e.g. changing the release number, link to release notes, etc.)
19:04:24 <darknao> I think I've already done the update https://gitlab.com/fedora/docs/fedora-linux-documentation/release-docs-home/-/commits/f38
19:04:29 <darknao> but it's not published yet
19:05:23 <darknao> so this is the next 2 tickets:
19:05:29 <darknao> #link https://gitlab.com/fedora/docs/docs-website/pages/-/issues/10
19:05:39 <darknao> #link https://gitlab.com/fedora/docs/docs-website/pages/-/issues/11
19:06:02 <pboy> Still ad updates: Did you adjust the text?
19:06:02 <darknao> We usually create the pull request for those, then merge them at release day
19:07:21 <pboy> OK, so I would modify the text in my current local repo as usual?
19:07:45 <darknao> yes, just use the new f38 branch
19:08:09 <pboy> OK, I check it later and ask, if I have a question.
19:08:34 <darknao> #link https://gitlab.com/fedora/docs/docs-website/pages/-/issues/12
19:09:01 <darknao> we can keep this one for now, we will create the F39 related tickets after the release
19:09:11 <darknao> no rush for it
19:09:38 <pboy> OK.
19:09:46 <hankuoffroad[m]> sure
19:10:00 <darknao> the next one is a task related to this ticket
19:10:05 <darknao> #link https://gitlab.com/fedora/docs/fedora-linux-documentation/release-docs-home/-/issues/4
19:10:14 <darknao> about the install guide
19:10:39 <pboy> Yes, I'm still in the process. .....
19:11:14 <pboy> There must exist a ticket about this that is assigned to me
19:11:30 <darknao> yes, this one :)
19:12:08 <darknao> so it's in progress, we can move on the next one
19:12:21 <darknao> #link https://gitlab.com/fedora/docs/docs-website/pages/-/issues/18
19:12:26 <pboy> yes, it's in progress
19:13:10 <pboy> We have to postpone it (18)
19:13:13 <darknao> the linked ticket has been closed, and the associated MR merged
19:13:35 <darknao> is there anything that need to be done here?
19:13:58 <darknao> or close it and reopen if we need to revisit something?
19:14:12 <pboy> yes, I have to write a summary of our discussion
19:14:21 <hankuoffroad[m]> did i close it incorrectly?
19:14:32 <pboy> Maybe, but no problem.
19:15:12 <pboy> Maybe, we close this topic and open a new one when we have something to discuss and to decide
19:15:22 <darknao> fine to me
19:15:24 <pboy> topic = related tickets
19:15:29 <hankuoffroad[m]> darknao: ok
19:15:44 <darknao> why not creating a discussion topic on discourse instead?
19:16:02 <darknao> seems more appropriate than a ticket, right?
19:16:39 <pboy> We did that some tme ago. And I have to write a sumary and 2-3 specific proposals what to decide.
19:17:01 <pboy> Yes, a I open a new thread,when I'm ready
19:17:08 <darknao> ok
19:17:47 <darknao> we have 15 minutes left, so let's move to the other 2 remaining topics for today
19:18:00 <darknao> #topic Quick docs update
19:18:12 <hankuoffroad[m]> darknao: to open issue ticket, we need to raise it on discussion?
19:18:21 <darknao> anything related to QD to discuss?
19:18:42 <pboy> OK, I finally did resume my work on QD and did some PRs, issues, etc
19:18:57 <darknao> hankuoffroad[m]: no need, but this one seems specific about having a discussion, so I'm not sure a ticket is the right place for that
19:19:01 <pboy> I have a minor technical issue
19:19:22 <hankuoffroad[m]> darknao: got iy
19:19:25 <hankuoffroad[m]> it
19:20:00 <darknao> hankuoffroad[m]: you'll have more involvment in a discussion topic than in a gitlab ticket than only a few reads
19:20:45 <darknao> pboy: we are listening :)
19:20:47 <pboy> yes, but at the ende of a discussion you often need a ticket to systematize the outcome.
19:20:58 <pboy> Ad technical:
19:21:06 <pboy> In Quickdoc local authoring & preview (on a Fedora server) the title "Category" shows up, but no category item and no tags. On the  published page they do.
19:21:29 <pboy> Is it just my Fedora release, or a systematic issue. And how to fix it?
19:22:22 <darknao> the category systems don't show up on local preview
19:22:22 <pboy> I tested it with a fresh cloned repo.
19:22:45 <pboy> OK, so it is systematic and by design?
19:22:53 <darknao> systematic yes
19:22:58 <pboy> OK.
19:23:16 <darknao> they are requirements that are only in the main docs repo (plugins)
19:23:22 <hankuoffroad[m]> pboy: will do. So far, I got easily absorbed and overwhelmed (or underwhelmed when silent) by discussion. So I like focused and small issue to be tracked...I realize I missed process to discuss, sometimes,
19:23:39 <darknao> and adding that the local preview make it way too complicated than it already is
19:24:17 <pboy> hankuoffroad[m] I just worked all you additions to the various docs. I think, they are great.
19:24:37 <pboy> Maybe I have some suggestions, in the next week or so.
19:24:58 <pboy> s/worked/followed/
19:25:24 <hankuoffroad[m]> pboy: thanks.
19:25:29 <darknao> 5 min left, do you have anything for open floor, or should we stay in QD topic?
19:25:45 <pboy> nothing open floor from mw
19:26:30 <hankuoffroad[m]> not really. I'm off for holiday with my family 27 - 31 March. Will slow down for a bit.
19:26:55 <darknao> have a nice holiday hankuoffroad[m] :)
19:27:07 <pboy> Regarding QD: we have 2 rather compless problems / issue, the local authoring description and eben more complex all that installing software.
19:27:55 <pboy> We should put them a bit back for the moment, until we resolved all or at least most of the nitpics
19:29:48 <darknao> ok
19:30:22 <darknao> we reach the end of the meeting, but we can discuss about that next time if needed
19:30:41 <hankuoffroad[m]> sure, thank to all.
19:30:51 <darknao> thanks everyone for today, and see you all next time
19:30:57 <darknao> #endmeeting