#meeting:fedoraproject.org log

<@jflory7:fedora.im>

13:01:59

!startmeeting Fedora Docs Team - 2026-03-24

<@meetbot:fedora.im>

13:02:00

Meeting started at 2026-03-24 13:01:59 UTC

<@meetbot:fedora.im>

13:02:00

The Meeting name is 'Fedora Docs Team - 2026-03-24'

<@jflory7:fedora.im>

13:02:04

!meetingname docs

<@meetbot:fedora.im>

13:02:05

The Meeting Name is now docs

<@pg-tips:fedora.im>

13:02:11

!hi

<@zodbot:fedora.im>

13:02:12

P G (pg-tips)

<@jflory7:fedora.im>

13:02:15

!topic Welcome & Hello's

<@jflory7:fedora.im>

13:02:17

!hi

<@zodbot:fedora.im>

13:02:19

Justin Wheeler (jflory7) - he / him / his

<@pboy:fedora.im>

13:02:19

!hi

<@zodbot:fedora.im>

13:02:21

Peter Boy (pboy)

<@hricky:fedora.im>

13:02:31

!hi

<@zodbot:fedora.im>

13:02:32

Hristo Marinov (hricky) - he / him / his

<@nielsenb:fedora.im>

13:02:35

!hi

<@zodbot:fedora.im>

13:02:37

Brandon Nielsen (nielsenb)

<@jflory7:fedora.im>

13:02:51

Good morning, folks!

<@jflory7:fedora.im>

13:03:14

This is the last week before time zones change again. It was nice having an extra hour to my morning before this meeting started :D

<@shaunm:matrix.org>

13:03:15

!hi

<@jflory7:fedora.im>

13:03:19

How are folks doing today?

<@hricky:fedora.im>

13:03:40

Good afternoon. 🙂

<@venefilyn:matrix.org>

13:03:45

!hi

<@zodbot:fedora.im>

13:03:49

Shaun McCance (shaunm) - he / him / his

<@zodbot:fedora.im>

13:03:49

Freya Gustavsson (venefilyn) - they / them / theirs or she / her / hers

<@jflory7:fedora.im>

13:06:32

Oh wow. That one was delayed 😁

<@jflory7:fedora.im>

13:06:38

And this one too, apparently

<@jflory7:fedora.im>

13:06:49

Ohhhhh the matrix.org accounts

<@pg-tips:fedora.im>

13:06:55

the bot is also feeling the time change :)

<@jflory7:fedora.im>

13:06:57

The federation lag is real 😬

<@jflory7:fedora.im>

13:07:04

Hah! Evidently.

<@jflory7:fedora.im>

13:07:11

Let's go ahead and get into the swing of things.

<@jflory7:fedora.im>

13:08:58

The first meeting of my day means it takes a minute for the tabs to get all pulled up 😄

<@jflory7:fedora.im>

13:09:07

!topic Team announcements & community news

<@jflory7:fedora.im>

13:09:14

Folks, anything to share or update?

<@jflory7:fedora.im>

13:09:56

!info The tentative date for the F44 Release Party is Friday, 24 April.

<@venefilyn:matrix.org>

13:11:14

Discovered Antora doesn't support SHA256 source/doc repos, but can workaround it by pre-downloading the repos (which we do in the OCP script)

<@jflory7:fedora.im>

13:11:18

!info Following the Fedora Council 2026 Strategy Summit (FCSS 2026), the Council has been working on a proposal to evolve how we recognize and empower our community members. As our project community ages and grows, we want to modernize our legal foundations (moving from a manual FPCA signing process to implicit consent via FAS authentication) and establish a new, human-centric tier of recognition: Fedora Verified.

<@jflory7:fedora.im>

13:11:21

!link https://discussion.fedoraproject.org/t/defining-a-fedora-verified-membership/182649

<@jflory7:fedora.im>

13:11:33

!info Discovered Antora doesn't support SHA256 source/doc repos, but can workaround it by pre-downloading the repos (which we do in the OCP script)

<@jflory7:fedora.im>

13:11:44

Venefilyn: You found a workaround?

<@venefilyn:matrix.org>

13:12:30

Sort of makes sense as Antora failed on cloning

<@venefilyn:matrix.org>

13:12:30

<@venefilyn:matrix.org>

13:12:30

Yeah, by accident. We already download all the repos before running Antora for the build script. Doing that made it all work

<@jflory7:fedora.im>

13:12:40

Hah 😄

<@jflory7:fedora.im>

13:12:46

Nice!

<@jflory7:fedora.im>

13:12:57

So does this mean less work for me? I don't have to delete and remake repos? 😄

<@venefilyn:matrix.org>

13:13:11

E.g.

<@venefilyn:matrix.org>

13:13:11

https://forge.fedoraproject.org/docs/docs-fp-o/src/commit/2732725f5ab392af5f02c3325149d9c788343e3e/build-scripts/rebuild-site.py#L151-L187

<@jflory7:fedora.im>

13:13:24

!link https://forge.fedoraproject.org/docs/docs-fp-o/src/commit/2732725f5ab392af5f02c3325149d9c788343e3e/build-scripts/rebuild-site.py#L151-L187

<@venefilyn:matrix.org>

13:13:47

Yes!

<@jflory7:fedora.im>

13:13:53

Yay!

<@jflory7:fedora.im>

13:13:57

I love less work 😄

<@jflory7:fedora.im>

13:14:17

Well, that's a good update 🙂

<@jflory7:fedora.im>

13:14:26

Are we fully moved over to the new Forge yet for the pipeline builds?

<@jflory7:fedora.im>

13:14:38

Or do we still need to figure out Forgejo Action runners and stuff like that?

<@venefilyn:matrix.org>

13:16:33

For docs we haven't done anything AFAIK with Forgejo actions et al

<@jflory7:fedora.im>

13:17:04

Petr Bokoc, Peter Boy (ServerWG, Docs): Do either of you know whether we have runners yet?

<@jflory7:fedora.im>

13:18:23

!info SHA256 git repositories no longer need to be converted to SHA1, thanks to a pre-fetching workaround

<@jflory7:fedora.im>

13:18:44

!info We do not yet have any Forgejo Action runners yet, but this is in-progress / needs an update

<@jflory7:fedora.im>

13:18:58

I think this is likely all of the announcements for now

<@jflory7:fedora.im>

13:19:03

Let's get to the main discussion topics

<@jflory7:fedora.im>

13:19:14

!topic Ticket triage and meeting review

<@jflory7:fedora.im>

13:19:24

!link https://forge.fedoraproject.org/docs/tickets/issues?q=&type=all&state=open&labels=3655

<@jflory7:fedora.im>

13:19:28

Wow, that's a lot!

<@jflory7:fedora.im>

13:19:31

Six tickets 😄

<@jflory7:fedora.im>

13:20:08

Peter Boy (ServerWG, Docs), Christian Strauf, MatH, Petr Bokoc: You all are our ticket openers. Anyone who wants to prioritize their ticket? Or should I just go bottom to top?

<@pboy:fedora.im>

13:21:54

Currentlky, I think just go, pro

<@jflory7:fedora.im>

13:24:14

OK. I'll do my sort. I see some tickets say they need team votes. Let's look at these ones first?

<@jflory7:fedora.im>

13:25:26

Hmm, except some of the tickets tagged for votes don't have a clear vote proposal

<@jflory7:fedora.im>

13:25:40

Some ticket triage work is needed, heh

<@jflory7:fedora.im>

13:26:28

[@korora:fedora.im](https://matrix.to/#/@korora:fedora.im) Are you here and willing to speak toward the new authoring guide?

<@jflory7:fedora.im>

13:26:52

[@theprogram:fedora.im](https://matrix.to/#/@theprogram:fedora.im), [@cstrauf:fedora.im](https://matrix.to/#/@cstrauf:fedora.im) Are y'all here to discuss the beginner's guide?

<@jflory7:fedora.im>

13:27:23

[@theprogram:fedora.im](https://matrix.to/#/@theprogram:fedora.im) [@hricky:fedora.im](https://matrix.to/#/@hricky:fedora.im) [@pg-tips:fedora.im](https://matrix.to/#/@pg-tips:fedora.im) Could any of you speak toward the Vale discussion?

<@cstrauf:fedora.im>

13:27:45

Sorry, I'm at work and currently unable to participate.

<@jflory7:fedora.im>

13:28:01

[@pboy:fedora.im](https://matrix.to/#/@pboy:fedora.im) Anything to discuss about the membership model?

<@jflory7:fedora.im>

13:28:07

OK, no problem, thanks for letting us know.

<@pboy:fedora.im>

13:29:08

Not today, we should discuss on discussion first, I think.

<@jflory7:fedora.im>

13:29:51

OK. Then I should untag the ticket for meeting discussion. We will want to find someone to make that post

<@pboy:fedora.im>

13:30:18

I'll do that post, containing my ideas about it.

<@jflory7:fedora.im>

13:30:37

Do we have any of the folks here with tickets to provide updates? Or do we want to go to open floor?

<@jflory7:fedora.im>

13:30:58

OK. Thanks! Should we also set a deadline for the task too?

<@pboy:fedora.im>

13:32:29

Yeah, I'll do it on Weekend latest, so we have nearly 2 weeks to discuss

<@jflory7:fedora.im>

13:34:55

!action @pboy Propose a membership model idea/concept (Ticket #5) in Fedora Discussion by Monday, 30 March

<@jflory7:fedora.im>

13:35:10

!topic Open floor

<@jflory7:fedora.im>

13:35:24

Well folks, we have other tickets, but I'm not sure we have the people present to discuss them.

<@jflory7:fedora.im>

13:35:32

Does anyone who is present want to bring something up?

<@jflory7:fedora.im>

13:35:40

What's on your mind, folks?

<@jflory7:fedora.im>

13:35:49

Or do we want half an hour back?

<@venefilyn:matrix.org>

13:36:25

One topic from me is that I've worked a bit on improving docs-fp-o repo a bit. Wanted to test out MermaidJS or PlantUML but got distracted with fixing things :D

<@pg-tips:fedora.im>

13:37:08

following up on something we ( @jflory7 and I) mentioned briefly on Matrix - what do we think the ownership model should be for "QuickDocsNG" after the initiative? i.e. who is responsible for writing and (maybe more important) keeping up to date the QuickDocs?

<@jflory7:fedora.im>

13:38:28

There we go, I knew folks had to have more reasons to be here than just to see me 😁

<@jflory7:fedora.im>

13:38:46

I saw you doing a bit but haven't been able to follow closely. Want to share a brief update about what you have been up to?

<@jflory7:fedora.im>

13:38:56

I have poked with the builder repo, but I haven't spent a lot of time with it

<@jflory7:fedora.im>

13:39:03

So, I'm curious what you have been up to

<@jflory7:fedora.im>

13:39:22

And I hope we finally fix that thing with the `main` branch being a hidden distraction for `prod` branch lol

<@jflory7:fedora.im>

13:39:50

I think this is related to Ticket #5 actually, and the proposal that Peter will write. But we can also chat about it some now too.

<@pg-tips:fedora.im>

13:40:03

aha, ok!

<@jflory7:fedora.im>

13:40:05

Do you have an idea or something to pitch?

<@venefilyn:matrix.org>

13:40:12

- Added npm package management

<@venefilyn:matrix.org>

13:40:12

- Updated the design docs repo from Pagure to Forge

<@venefilyn:matrix.org>

13:40:12

- Fixed accounts docs link pointing to a different repo

<@jflory7:fedora.im>

13:41:08

npm package management for some JS dependencies and stuff in the UI theme? Or something else?

<@pg-tips:fedora.im>

13:41:17

I don't have a firm idea - but I think clear maintenance ownership is really important, otherwise docs will inevitably slip out of date

<@venefilyn:matrix.org>

13:41:45

npm for all the JS dependencies yeah, makes it more reproducible and easier to manage. Still need to update containers to use it though

<@jflory7:fedora.im>

13:41:59

Yes, agreed. My short and fast idea is that I think we need topic captains in the same way that we have language coordinators in the Localization team.

<@venefilyn:matrix.org>

13:42:01

We already use npm to install in the containers but we don't have any package.json or package-lock.json files

<@pboy:fedora.im>

13:42:10

Regarding QuickDocNG, i would think wie integrate that into the curent QD infrastructure and use one. group / team for it.

<@pg-tips:fedora.im>

13:42:12

look forward to seeing the proposal! (now I look at ticket #5 I see that Quickdocs is an integral part of that)

<@jflory7:fedora.im>

13:42:32

I imagine this makes caching faster too

<@jflory7:fedora.im>

13:43:11

Maybe I am naïve but is QuickDocsNG different from Quick Docs?

<@pg-tips:fedora.im>

13:43:37

AIUI QuickDocs NG = current QuickDocs + (some substantial part of) current SysAdmin guide

<@jflory7:fedora.im>

13:44:44

Oh huh. I feel surprised that this is new knowledge to me. But I also haven't been paying close attention

<@jflory7:fedora.im>

13:46:57

Who was maintaining the Sysadmin Guide before? Are we still publishing that?

<@pg-tips:fedora.im>

13:47:26

I don't know who was doing it, but it's still available on the web

<@pboy:fedora.im>

13:47:34

Yeah, maybe we need a better name for QuickDocs, but until now I didn't had a convincing idea. :-)

<@pg-tips:fedora.im>

13:47:40

quite a bit is worth retaining, with suitable adaptation

<@pg-tips:fedora.im>

13:47:57

https://forge.fedoraproject.org/docs/tickets/issues/7

<@pboy:fedora.im>

13:49:11

Yeah, I'm working my way through the analysis to determin a detailled proposal what to do next. But it is a lot!

<@pboy:fedora.im>

13:50:12

And we have to coordinate the content inprovement and the graphical improvement and the logical improvement /categories / tags instead of static navigation)

<@pboy:fedora.im>

13:50:31

And we have to coordinate the content inprovement and the graphical improvement and the logical improvement (categories / tags instead of static navigation)

<@pboy:fedora.im>

13:51:06

This endevour is a bit complex.

<@jflory7:fedora.im>

13:51:41

I think one part of the puzzle is finding someone to be the Quick Docs content head.

<@jflory7:fedora.im>

13:51:49

I don't think we have clear ownership there

<@jflory7:fedora.im>

13:52:00

And someone to help organize and lead things there would be very helpful

<@pboy:fedora.im>

13:52:39

Well, the owner is cuirrently the initiative team.

<@pboy:fedora.im>

13:53:03

And I think, that is mandatory. We promised a specific concept for this.

<@pboy:fedora.im>

13:53:18

And we need wider support from tjhe community, of course.

<@pboy:fedora.im>

13:53:35

Bat first we should have a solid overall plan.

<@jflory7:fedora.im>

13:54:01

But I don't think this is the sustainable approach. The Initiative team has a lot on our plate, and we should be guiding more than doing ourselves. Where we can help it, at least!

<@jflory7:fedora.im>

13:54:13

And I think a lot of people are interested in Quick Docs

<@jflory7:fedora.im>

13:54:25

A big part of this should be leaving room for someone new to lead

<@jflory7:fedora.im>

13:54:50

Because if it is me, Peter, or Petr running Quick Docs… I think we would miss the forest for the trees 😄

<@ichavero:fedora.im>

13:55:57

I want to help, can't promise full time but I think I can spare some time on the docs

<@ahmedalmeleh:matrix.org>

13:56:44

Is a meeting happening now?

<@jflory7:fedora.im>

13:57:04

Anyways, much to think about. I hope someone who is already engaged and interested in Quick Docs could take the lead here. I know people care because it keeps coming up in discussions. But for now, we will have to take this at the slower pace things go when me, Peter, and Petr have to own things.

<@jflory7:fedora.im>

13:57:18

I'd love to see ideas and thoughts on how to solve this for Ticket #5

<@jflory7:fedora.im>

13:57:21

Yes

<@jflory7:fedora.im>

13:57:29

Awesome! Which ones?

<@jflory7:fedora.im>

13:58:33

We are two minutes to close, FYI

<@jflory7:fedora.im>

13:58:42

Any last things folks want to put out there?

<@ichavero:fedora.im>

14:00:19

I was looking at ticket #7 I could start helping with that one but I don't know the workflow

<@jflory7:fedora.im>

14:00:21

OK, well, that's time for today, folks.

<@jflory7:fedora.im>

14:00:29

Drop a comment in the ticket! Let's chat!

<@jflory7:fedora.im>

14:00:37

Unfortunately, our hour is up and we need to yield the room.

<@jflory7:fedora.im>

14:00:41

Thanks folks for being here today.

<@jflory7:fedora.im>

14:00:45

Until next time…

<@jflory7:fedora.im>

14:00:48

!endmeeting