docs
LOGS
18:30:23 <darknao> #startmeeting docs
18:30:23 <zodbot> Meeting started Wed Apr 26 18:30:23 2023 UTC.
18:30:23 <zodbot> This meeting is logged and archived in a public location.
18:30:23 <zodbot> The chair is darknao. Information about MeetBot at https://fedoraproject.org/wiki/Zodbot#Meeting_Functions.
18:30:23 <zodbot> Useful Commands: #action #agreed #halp #info #idea #link #topic.
18:30:23 <zodbot> The meeting name has been set to 'docs'
18:30:32 <darknao> #topic Roll call
18:30:38 <darknao> #chair pboy darknao pbokoc py0xc3[m]
18:30:38 <zodbot> Current chairs: darknao pbokoc pboy py0xc3[m]
18:30:49 <pboy> .hi
18:30:50 <zodbot> pboy: pboy 'Peter Boy' <pboy@uni-bremen.de>
18:32:09 <hankuoffroad[m]> .hello hankuoffroad
18:32:10 <zodbot> hankuoffroad[m]: hankuoffroad 'None' <allegrovelo@gmail.com>
18:32:14 <darknao> hi o/
18:32:38 <darknao> #topic Agenda
18:32:44 <darknao> #link https://discussion.fedoraproject.org/t/docs-meeting-agenda-2023-04-26/81634
18:32:46 <darknao> #info Announcements
18:32:48 <darknao> #info Tickets review
18:32:50 <darknao> #info Quick docs update
18:32:52 <darknao> #info Docs plan for the next year
18:32:54 <darknao> #info Open Floor
18:32:56 <darknao> #topic Announcements
18:33:02 <darknao> #info F38 has been released
18:33:04 <darknao> #info We use GitLab to track work: https://gitlab.com/groups/fedora/docs/-/boards
18:33:14 <darknao> anything else to add here?
18:33:22 <pboy> no
18:33:49 <darknao> I do
18:34:02 <darknao> #info darknao will step down a bit from the docs team
18:34:20 <darknao> So I need to focus on other things right now, and I've no longer the time to work actively on the docs team (not that I've been very active lately anyway)
18:35:06 <pboy> that's bad news!
18:35:14 <hankuoffroad[m]> so it is temporary?
18:35:21 <darknao> that's also mean I'll not chair this meeting anymore
18:35:26 <pboy> what do you mean with "a bit"?
18:36:14 <darknao> I mean, I'll not be active anymore (but since i've not been very active lately, that should not be a big change)
18:36:56 <darknao> and I'll not be able to chair this meeting. But I'll still be around, to work on the tooling or the website, if the time permits
18:36:58 <pboy> Well, you did all the technical things.
18:38:51 <hankuoffroad[m]> That's a shame. Yes, we can work on technical side.
18:39:11 <darknao> anyway, I don't think you'll see any differences, I'm just making official the fact that I'm not able to focus fully on the docs from quite some time already
18:40:23 <darknao> ok, let's proceed with this meeting
18:40:27 <darknao> #topic Tickets flagged for meeting
18:40:38 <darknao> I think there are 2 tickets to review
18:40:49 <darknao> #link https://gitlab.com/fedora/docs/docs-website/pages/-/issues/22
18:41:48 <hankuoffroad[m]> it can wait considering workload in the website team
18:42:18 <darknao> I believe this is an issue with dark mode not showing the menu icon, right?
18:42:19 <pboy> Looks like a CSS issue and probably a browser issue.
18:42:34 <darknao> or more precisely, a contrast issue
18:42:36 <hankuoffroad[m]> Yes
18:43:16 <pboy> contrast issue to be resolved on the phone or in the CSS?
18:43:36 <darknao> that a css issue
18:43:53 <pboy> It works fine on my iPhone
18:44:16 <pboy> so you may need browser specific CSS here?
18:44:17 <darknao> I'm moving this issue to the Fedora Docs UI repo
18:44:25 <darknao> #link https://gitlab.com/fedora/docs/docs-website/ui-bundle/-/issues/10
18:45:12 <darknao> and adding the good_first_issue tag as it seems quite easy to implement
18:45:26 <darknao> next one
18:45:31 <darknao> #link https://gitlab.com/fedora/docs/community-tools/documentation-contributors-guide/-/issues/27
18:45:38 <hankuoffroad[m]> darknao: ok
18:46:13 <pboy> That was a reminder
18:46:36 <pboy> We have to deal with the translation any time soon, I think.
18:47:02 <pboy> But we can comment it out ind nav.adoc for now
18:47:33 <hankuoffroad[m]> I recently got in touch with localization team. Unless Docs team needs different context, we could remove the link. No what I mean is there seems no separate page to write about translation.
18:47:57 <darknao> so I'm not sure here, can we just link to the l10n page you mentionned?
18:48:07 <hankuoffroad[m]> yes, comment it out. It is localization team's managing it...it could.
18:48:16 <darknao> I don't think there is anything to say more than that on the documentation side
18:49:36 <hankuoffroad[m]> pboy: we have two different opinions.. 1) comment it out 2) link to i10n team
18:49:39 <pboy> OK, what are we doing und who does it?
18:50:34 <pboy> I would comment it out until we know about localization of docs articles.
18:50:49 <pboy> But if you prefer to link, it's fine for me!
18:52:01 <darknao> we can add a small abstract on the l10n page to say that the translation happen on Weblate, and how to find docs related project on the platform
18:52:10 <hankuoffroad[m]> hmmm, will check translation metrics for Docs and reply on the issue
18:52:22 <hankuoffroad[m]> darknao: that'll do
18:52:29 <darknao> by we, I mean me, since I'm also on the l10n team
18:52:56 <hankuoffroad[m]> wow, you have many hats :)
18:52:56 <pboy> Best, darknow will write the paragraph
18:53:04 <darknao> and I'm the author of this page anyway
18:54:11 <hankuoffroad[m]> Good to know
18:55:53 <darknao> ok that's all for the tickets
18:56:02 <darknao> #topic Quick docs update
18:56:14 <darknao> anything related to QD?
18:56:35 <pboy> not from me at the moment
18:56:41 <hankuoffroad[m]> not that I know of
18:57:13 <darknao> alright, next topic then
18:57:15 <darknao> #topic Docs plan for the next year
18:57:46 <darknao> #link https://discussion.fedoraproject.org/t/possible-docs-team-work-plan-for-the-f39-f40-period/81122/27
18:58:04 <pboy> Probably we go step by step through my summary?
18:58:28 <pboy> First step would be item 5 - Release Notes.
18:58:51 <pboy> Or is there a more generic remark?
18:59:45 <hankuoffroad[m]> pboy: that's handy, sure
19:00:08 <pboy> OK, item 5 - Release Notes
19:00:12 <darknao> from this summary, I can see there is few decision to take (Items 4-2-1)
19:00:20 <darknao> maybe we can start with that?
19:00:55 <pboy> Yes, but that iem 6, too.
19:00:59 <pboy> item 5
19:01:23 <pboy> You were the one to make the scripting when we discussed that some seeks ago.
19:01:45 <pboy> And to know enough about Antorra to make it work.
19:02:11 <darknao> I was?
19:02:27 <pboy> darknao Yes, you. :-)
19:05:52 <darknao> I don't remember it, but I also have a very bad memory
19:06:44 <pboy> We agreed I will write the change proposal and discuss with Fesco, and you would take over the technical side.
19:07:05 <pboy> Question is, what do we now?
19:08:34 <darknao> I guess I need to write a script then?
19:09:26 <pboy> Well, the question is, can you do it? Do you have the capacity to do it?
19:09:47 <pboy> I think, it is not a matter of 1 day or 2
19:09:58 <darknao> I don't think we need to spend to much time on it, no one here is managing the release notes anyway
19:10:51 <pboy> Yeah, therefore the idea to automate it as much as possible
19:11:14 <darknao> right, but doing it in the next days, or month, or even year, is not going to change anything
19:11:55 <darknao> I mean, it's nice to have, but I don't think that's something that need to be done asap
19:12:30 <pboy> I think, if we could develop such a script we would have much better and complete release notes for F39. So it would change a lot.
19:13:23 <darknao> That's mean I need to write a working script before F39
19:13:30 <darknao> that's not going to happen :p
19:14:11 <pboy> Well, F39 could be the beta test, so to speak. And with F40 it could become the standard procedure.
19:14:53 <pboy> Or do we have to declare defeated and kill the project?
19:15:41 <darknao> I think we can find a middle ground between killing the idea, and doing it for the next release
19:16:15 <darknao> This is a good idea, we can put it on our backlog, but I can't make any statement on when it'll be done (or even started)
19:16:52 <hankuoffroad[m]> darknao: sounds like a plan
19:17:22 <pboy> OK, so we declare defeated.
19:17:54 <pboy> and kill the project, or postpone it to F100 or so.
19:18:02 <pboy> :-)
19:18:43 <darknao> F100 seems like a possible target
19:18:54 <darknao> hopefully before that
19:20:19 <pboy> Yeah, hope dies last.
19:23:54 <pboy> We have about 5 minutes left. We should talk about how we proceed
19:24:19 <pboy> Probably with Open floor?
19:25:09 <hankuoffroad[m]> we don't have a minimum number of people to run weekly Docs meeting. Do we need to postpone the meeting until further notice and get on with priorities?
19:25:22 <darknao> #topic Open Floor
19:26:22 <pboy> We don't have a minimum number. Nevertheless we must talk about organizational things.
19:26:50 <pboy> Who will chair next meeting? According to our governance, it is a member of the board.
19:27:07 <pboy> darknao is stepping down.
19:27:23 <pboy> and now?
19:27:53 <pboy> A related problem: none of those who ran active Antorra are still active on the docs team. And neither are any of those who ran the switch to GitLab.
19:28:35 <hankuoffroad[m]> What is the impact?
19:28:48 <pboy> We don't have an active person who can sort out all the ongoing issues.
19:29:49 <pboy> Or: The ....  are leaving the sinking ship ??
19:29:56 <pboy> without replacement
19:30:53 <hankuoffroad[m]> little time left today, so until further notice Docs team is on pause. This does not mean we stopped doing work, but will slow down.
19:31:30 <pboy> Yeah. we may discuss it on discussion or in a ticket.
19:31:48 <pboy> Or on matrix.
19:31:53 <darknao> even if you decide to not meet weekly, you can still continue what you were doing on discussion
19:32:45 <hankuoffroad[m]> darknao: yes, thanks for your support so far in Docs, and we will be in the Fedora project(s).
19:33:09 <hankuoffroad[m]> pboy: i'm available.
19:33:14 <darknao> anyway, meeting is over. THanks everyone for coming
19:33:18 <darknao> #endmeeting