docs
LOGS
18:31:35 <darknao> #startmeeting docs
18:31:35 <zodbot> Meeting started Wed Sep 21 18:31:35 2022 UTC.
18:31:35 <zodbot> This meeting is logged and archived in a public location.
18:31:35 <zodbot> The chair is darknao. Information about MeetBot at https://fedoraproject.org/wiki/Zodbot#Meeting_Functions.
18:31:35 <zodbot> Useful Commands: #action #agreed #halp #info #idea #link #topic.
18:31:35 <zodbot> The meeting name has been set to 'docs'
18:31:41 <darknao> #topic Roll call
18:31:47 <darknao> .hi
18:31:47 <pboy> .hi
18:31:48 <zodbot> darknao: darknao 'Francois Andrieu' <darknao@drkn.ninja>
18:31:51 <zodbot> pboy: pboy 'Peter Boy' <pboy@uni-bremen.de>
18:35:18 <darknao> so we are only 2 today?
18:35:54 <pboy> Seems to be, not exactly crowded today
18:36:16 <darknao> pboy do you want to proceed or shall we postpone to next week?
18:36:59 <pboy> I think, we should let the meeting open for at least 15 mins.
18:37:50 <pboy> And regard next meeting, I will probably not be able to attend next Wednesday.
18:38:26 <pboy> But for sure in 2weeks again!
18:43:55 <pboy> I would like to know how I can continue with our new pages.
18:44:03 <pboy> But that might be more comfortable with e-mail than here with one-liners - if you don't mind.
18:44:42 <darknao> ok so I propose to still go over all the topics, in case there is anything we need to brings up, and if there is nothing to say, it'll just be a short meeting :)
18:44:56 <pboy> OK
18:45:11 <darknao> #chair pboy darknao
18:45:11 <zodbot> Current chairs: darknao pboy
18:45:12 <darknao> let's go
18:45:16 <darknao> #topic Agenda
18:45:23 <darknao> #link https://discussion.fedoraproject.org/t/docs-meeting-agenda-2022-09-21/42582
18:45:25 <darknao> #info Announcements
18:45:27 <darknao> #info Action item followup
18:45:29 <darknao> #info ankursinha’s improvements for the preview.sh/build.sh
18:45:31 <darknao> #info How to proceed with Release Notes Fedora 37
18:45:33 <darknao> #info Discussion of the Fesco ticket regarding release notes
18:45:35 <darknao> #info Status variant-orientated docs plan
18:45:37 <darknao> #info Additional repo ownership of “Fedora Linux Workstation and Spins User Guide”
18:45:39 <darknao> #info Maintenance strategy for “Fedora Linux Workstation and Spins User Guide”
18:45:41 <darknao> #topic Announcements
18:45:53 <darknao> #info Some F36 release notes still need to be written https://pagure.io/fedora-docs/release-notes/roadmap/F36
18:45:55 <darknao> #info F37 Beta has been released!
18:45:57 <darknao> #info We use GitLab to track work: https://gitlab.com/groups/fedora/docs/-/boards
18:46:19 <darknao> no other announcements?
18:46:30 <pboy> nope
18:46:33 <darknao> #topic Previous action items
18:46:38 <darknao> #info none!
18:46:50 <darknao> #topic ankursinha’s improvements for the preview.sh/build.sh
18:47:07 <darknao> #link https://discussion.fedoraproject.org/t/improved-build-script-for-doc-repos-with-change-detection/40920/11
18:47:45 <pboy> I basically appreciate the work
18:48:03 <pboy> But don't know about the technical details
18:48:10 <darknao> it looks fine to me
18:48:39 <pboy> OK, what are the next steps needed?
18:49:09 <darknao> I'll review the MR later this week, but I don't think there will be anything to add to it. Looks good.
18:49:21 <pboy> OK.
18:49:40 <darknao> the other proposal was about building a RPM to distribute this script
18:49:44 <pboy> It would be nice to get information about how to update the pagure repos.
18:49:48 <darknao> I like that idea
18:50:04 <pboy> I'm fine with it, too
18:50:25 <darknao> but, that's only working for Fedora users, while the current script can be used on any distribution, even MacOS
18:51:02 <pboy> OK, I use MacOS and would like to use it as well. :-)
18:51:26 <darknao> so should we keep both? but in that case, I'm not sure the RPM will solve anything as we'll still have to maintain the script in all git repos
18:51:44 <pboy> So we need at least 2 distribution methods?
18:52:45 <darknao> I've no idea how things are packaged on mac
18:53:24 <pboy> I'm not sure, too. But I think it is too much effort.
18:53:42 <pboy> we should enable all repos to get it.
18:54:06 <darknao> and honestly, in this specific case, I'm not sure if it is worth working on updating every repo with that script
18:54:28 <darknao> I mean, the new script is nice, but it's not a hard requirement either to build the doc
18:54:37 <pboy> Probably not every repo, but those who are active?
18:54:52 <pboy> Or those, who would like to have it?
18:55:13 <pboy> I think, the repo owner should do the work.
18:55:20 <darknao> so if doc maintainers want to use it, they are more than welcome to update it, but otherwise, I think we should just focus on our own repos for starter
18:55:32 <darknao> exactly
18:55:53 <pboy> OK, but we should provide the information somewhere.
18:56:09 <pboy> E.g. I would really like to use it with our server repo.
18:56:53 <pboy> And we also need the new graphics
18:57:10 <pboy> graphics UI, I mean
18:57:49 <darknao> so usually, everything related to doc repo is comming from the template repository. That's basically the upstream.
18:58:31 <pboy> OK. So we should describe somewhere how to do the update.
18:58:35 <darknao> so all the new stuff are used there, and you can just use whatever is in this repo to update yours.
18:59:10 <pboy> OK, I'll have a look and ask questions if I don't understand it.
18:59:49 <darknao> for the updated UI, the repo for it is here: https://gitlab.com/fedora/docs/docs-website/ui-bundle and the readme have the required documentation to set it up
19:00:23 <pboy> Thanks, I'll try it.
19:02:12 <py0xc3[m]> .hello py0xc3
19:02:13 <zodbot> py0xc3[m]: py0xc3 'Christopher Klooz' <py0xc3@my.mail.de>
19:02:18 <py0xc3[m]> (but only for 10 minutes)
19:02:30 <darknao> should we agree on the script deployment? or address this next time when more people are here?
19:02:44 <darknao> oh hey py0xc3[m] :)
19:02:47 <pboy> I think, next time
19:02:52 <py0xc3[m]> good evening :)
19:02:55 <pboy> to be honest
19:03:03 <darknao> alright, let's move on then
19:03:11 <pboy> py0xc3[m]. Good morning. :-)
19:03:15 <darknao> #topic How to proceed with Release Notes Fedora 37
19:03:54 <pboy> I think we need someone who takes care of it.
19:04:09 <darknao> So I have no opinion on this, I think it's too late for F37 to change anything. I assume we will do just like the previous version
19:04:30 <pboy> Yes, in is too late for any change.
19:05:05 <pboy> We can just let it go and look what the result is, or we finde someone to care
19:05:32 <darknao> I've tried to write a few last week, so I think I could help a little for F37
19:06:24 <darknao> Some are easier than other depending on how much details there are in the change proposal in the wiki
19:06:33 <pboy> Good, but I think we need nevertheless someonw who oversees the complete process? I can't, and you probably neither
19:07:14 <pboy> Would pbokoc take it?
19:07:33 <darknao> yeah I guess that depends what kind of changes this is about
19:07:58 <pboy> Hm, we don't know
19:07:59 <darknao> for something about a version bump, it's quite easy to write the changelog
19:08:16 <pbokoc> Oh crap, I didn't realize it was that time again
19:08:28 <pbokoc> Yeah I'll oversee it
19:08:36 <pboy> Oh, welcome!
19:08:45 <darknao> hi pbokoc :)
19:08:52 <pbokoc> Hello :)
19:08:52 <py0xc3[m]> Welcome pbokoc
19:09:18 <pboy> We are discussin rel notes 37.
19:09:44 <pboy> pbokoc Would you take care for it?
19:09:55 <pboy> of it?
19:10:02 <pbokoc> pboy, Yeah, I know. Yes, I'll do it
19:10:09 <pboy> Great !!!
19:10:39 <darknao> I think we can agree that for F37 we keep it as usual, and we will see what we can do to improve the process for F38
19:10:50 <pbokoc> Agreed darknao
19:11:04 <pboy> me too
19:11:31 <darknao> and that a good transition to the next topic
19:12:10 <darknao> #topic Discussion of the Fesco ticket regarding release notes
19:12:28 <darknao> #link https://pagure.io/fesco/issue/2868
19:13:20 <pboy> For the time being we should just discuss. If I got everything right
19:13:38 <pboy> or if we have to korrect something
19:14:07 <pboy> Otherwise, we can only wait and see. I suppose
19:16:42 <darknao> well, I have nothing to add here. We can wait a bit more, the ticket is relatively new anyway
19:16:54 <pboy> OK
19:17:24 <darknao> next one is...
19:17:29 <darknao> #topic Status variant-orientated docs plan
19:18:36 <darknao> I think I had something to do this week, but didn't :/
19:18:57 <darknao> ie. setting up the staging environment
19:19:12 <darknao> will do that later today
19:19:15 <py0xc3[m]> Unfortunately, I have to go already :( I'll check the log later. See you around!
19:19:36 <pboy> Sorry see you later
19:19:38 <darknao> see you next time py0xc3[m]
19:20:03 <pboy> darknao yes. I plan to start on the weekend it possible.
19:20:38 <darknao> ok it'll be ready by then
19:20:47 <pboy> Thanks!
19:20:59 <darknao> any other update on this topic?
19:21:05 <pboy> not yet
19:21:25 <darknao> #topic Additional repo ownership of “Fedora Linux Workstation and Spins User Guide”
19:21:48 <darknao> #link https://discussion.fedoraproject.org/t/docs-meeting-agenda-2022-09-21/42582/4
19:22:11 <pboy> Besides the ownership, do we know if it is about the labs as well?
19:24:02 <pboy> I suppose, I don't get it what the problem exactly is.
19:24:45 <darknao> I don't see anything related to Labs, but I think only py0xc3 is able to answer that
19:25:17 <pboy> Regarding labs, indeed, I'll ask him
19:26:16 <darknao> about the issue, now that the repo is hosted in the Fedora namespace, py0xc3 lose owner/maintener access to it and there is a few things he cannot do anymore
19:26:46 <pboy> Regarding maintenance of the pages, if he is our main maintainer, can't he get commit priviliges?
19:26:50 <darknao> I've no objection giving him owner or maintainer perms on it, assuming I can do that
19:27:27 <pboy> I've neither. I'm lucky he takes the initiative.
19:28:21 <darknao> ok, just added him as owner of the repo
19:28:32 <pboy> OK1
19:28:44 <darknao> very quickly, last topic
19:28:49 <darknao> #topic Maintenance strategy for “Fedora Linux Workstation and Spins User Guide”
19:29:06 <darknao> #link https://discussion.fedoraproject.org/t/docs-meeting-agenda-2022-09-21/42582/4
19:30:06 <pboy> Is it about maintenance or licensing?
19:30:13 <darknao> I didn't read the maintener.md in the repo yet, and since we're close to the end, I propose to postpone this topic to the next meeting
19:30:23 <darknao> #link https://gitlab.com/fedora/docs/fedora-linux-documentation/fedora-linux-workstation-spins-guide/-/blob/main/MAINTAINER.md
19:30:24 <pboy> agreed
19:30:53 <darknao> ok, so that's it!
19:31:10 <darknao> thank you everyone, and see you all next week
19:31:20 <pboy> darknao++
19:31:20 <zodbot> pboy: Karma for darknao changed to 1 (for the current release cycle):  https://badges.fedoraproject.org/tags/cookie/any
19:31:21 <darknao> #endmeeting