Meeting started at 2026-07-28 13:00:49 UTC

The Meeting name is 'Fedora Docs Team Meeting - 2026-07-28'

!hi

!hi

!hi

!hi

!hi again

Sorry, but Fedora Accounts user 'again' does not exist

!hello

!hi

!hi

!hi

Jocelyn Gould (UTC-4): Jocelyn Gould (korora) - she / her / hers

Sorry, could not get info from FASJSON (code 500)

Justin Wheeler: Justin Wheeler (jflory7) - he / him / his

Ro: Rowan Puttergill (goroboro) - he / him / his

Good `$TIME_OF_DAY`, folks 👋

!hi

Eli Ridge: Eli Ridge (egret)

!hi

Hristo Marinov: Hristo Marinov (hricky) - he / him / his

Hello

I tend to do Good <$TIMEZONE>

I dunno, "Good Central European Summer Time" doesn't exactly roll off the tongue

Ananya Nalavathu: you need a "!hi"

this gets zodbot to add you to the roll-call

Maybe we should write some docs on this... ;)

You don't actually need to do that, zodbot doesn't do anything with it. Instead it counts lines said by unique accounts during the meeting

e.g. here at the bottom: https://meetbot.fedoraproject.org/meeting_matrix_fedoraproject-org/2026-07-14/fedora-docs-team-meeting-2026-07-14.2026-07-14-13.00.html

The alternate is doing `!localtime` for each attendee individually 😄

!localtime Petr Bokoc

Anyway!

Any no surprise, I'm in last place...

!hi

Thanks a million :)

I haven't done much because I was dying. There was one for @hricky about the build monitoring/reporting, Gwmngilfen offered help after the mtg as well so I suppose that's ongoing. Also, once again, everyone check out [#46](https://forge.fedoraproject.org/docs/docs-fp-o/pulls/46), [#50](https://forge.fedoraproject.org/docs/tickets/issues/50), and [#51](https://forge.fedoraproject.org/docs/tickets/issues/51)

Ahh, I forgot - before we get to today's agenda.

Glad you're still alive and with us!

Anyone else have anything to announce?

If I die I'll just haunt Matrix from beyond the grave

Yes

I have an announcement which comes out on Thursday on the Fedora Magazine, but for now, it is a surprise 😛

^^ a nice recap of Flock

And the video uploads of sessions are coming Very Soon™

They are all in YouTube now, just need to get scheduled and published

This will probably just look like my cats intruppting a releng meeting...

cool

OK, so from me:

This is our “relaunch landing page” project

I’ve just updated the Docs landing page on stg and added a section on contributions.

It should be visible in about 2 hours.

Address: docs.stg.fedoraproject.org

Oh, from Ananya Nalavathu too 😄

Hahah yeah I saw that

Yeah, visible after the next rebuild!

Awesome. Anything else? 5... 4... 3...

None from me

Alright, let's get to the agenda then

Also, we could touch on Quick Docs as well here

I think there are two topics here, right? UI/UX and information architecture?

Well, the design work can start not before 2-3 months, I guess.

Yes, information architecture and content we can discuss now.

And we can discuss content, e.g. of docs landing page. I tried to contact join SIG about ideas to the new contributor section. But they seam not to answer an nobody like me.

Has someone else an idea how to get them involved?

Where did you ask?

I asked in Matrix room.

I would usually tag [@ankursinha:fedora.im](https://matrix.to/#/@ankursinha:fedora.im) or [@theprogram:fedora.im](https://matrix.to/#/@theprogram:fedora.im) if I get stuck with Join SIG

I think we're gonna need a set of guidelines that clearly detail what goes where on the frontpage, because currently it's a bit of a mess. I know there was an attempt to develop those ages ago, but I don't think we ever managed to finish.

Well, i think it is not THAT of a mess.

There is some systematic, and some spontanious additions.

I did say "a bit" :)

What did we discuss before?

Do we remember? 😅

Where is the source of the front page?

Regarding the current home page, the dark blue part of the user section is very systematic.

I just have a vague recollection tbh. We were talking about this long before the docs initiaitive even started.

The light blue one is a bit "on demand".

https://forge.fedoraproject.org/docs/site-frontpage

what is the CSS requirement?

just interested in what people are hoping for?

There were improvements we wanted to do for categories and tags, if I remember right

The css the easiest part. The design ideas are crucial.

Quick Docs has some of this but it is not consistent, IIRC

I like easy 🤣

hmmm I will keep an eye on this.... I might be willing to help out at some stage

Content wise we should start to add / collect ideas what to put in the new contributor section.

Will there be one subsection for docs contributions ?

When @jesschitas:fedora.im has more time on her hands, I'm sure she would be a willing collaborator. She was going to drive some of this based on conversations which happened at Flock, but she got slammed with other high-priority work for next month or tdo

*or two

Eli Ridge: I hope so. As soon as we manage to restructure our current repo.

Cool... I will look out for her.

Justin Wheeler: Agreed, regarding Jess. That doesn’t have to stop us from working on the content and structure. It just makes it more difficult without good visual feedback.

Ok, let's move on

The current proposal for a landing page is available at https://pboy.fedorapeople.org/draft/

I transferred that to docs stg.

Yeah, I think we already have a PR for that.

So. I found out while splitting the team-docs repo into modules that... including modules from different components (repos) works a bit weird. I still need to dig into it but there's a chance that we'll have to unify the `name:` key in every repo's `antora.yml` so they match because I think it's not possible to combine modules from multiple repos otherwise.

There are "secret" proxy redirect rules for docs sites in Fedora Infra Ansible, if we need something more comprehensive than Antora `page-aliases`

Ohhh wait. Multiple repos for the same Antora component?

`name: beginners-guide` is published at https://docs.fedoraproject.org/en-US/beginners-guide/

If that has to happen it's gonna be super fun, because the name key shows up in the URL. For example:

`name: fedora` is published at https://docs.fedoraproject.org/en-US/fedora/latest/

Like, `/docs-team/` having two different repos for different content?

Yeah.

Nifty. I've wondered about that and if it was possible in other docs sites

I understood that different. We have one repo, but inside 2 modules.

That we have quite often.

Yes, multiple modules in the same repo is status quo. Lots of sites do rhat.

E.g. landing page has 6 or 8 modules

Yes, multiple modules in the same repo is status quo. Lots of sites do that.

It's both at the same time, actually.

https://forge.fedoraproject.org/docs/release-docs-home/src/branch/f44/antora.yml

https://forge.fedoraproject.org/docs/release-notes/src/branch/f44/antora.yml

So for example, these two repos have the same `name:`:

Hm, that's strange.

And that seems to be what allows us to publish both at the same time here: https://docs.fedoraproject.org/en-US/fedora/latest/. The table of contents shows you both. But that only seems possible if they have the same `name:`.

But it looks like you can't take a module from a repo (component) with a different `name` and include it as well. There's no way to define it.

You can see it here on lines 7 and 8: https://forge.fedoraproject.org/docs/release-docs-home/src/branch/f44/antora.yml

There's nothing in the syntax that specifies the component (`name`), so it has to be the same one.

Yeah so anyway, we're probably gonna need a billion redirects. Fun! :)

I'm trying to wrap my head around how this is possible 😳🫪

Yeah, wondering, too

Sounds like a job for regex

Yeah I don't understand why antora doesn't just use the same syntax as xrefs, includes, etc. That would solve the whole problem

Ok so before anyone's head explodes :D

Too late

This is an older one but it's still not finished, and I'd really like to finally knock it out

Ref: https://forge.fedoraproject.org/infra/ansible/src/commit/a8aca946f227e3c13b897c7af5c3e1218e67a1cd/playbooks/include/proxies-redirects.yml#L906

Instructions are in the comments, so if anyone has some spare time, grab a $beverage and go delete some pages please

Also, has anyone seen Christian Strauf recently?

Ahh, I forgot about halp

Sorry, on vacation.

I was just looking for an excuse to burn MediaWiki content to ashes 😛

Oh hey Christian :D No worries, I was just wondering

It’s mostly just plain, hard work.

I think he might be on vacation... ;)

Justin Wheeler There's also a similar issue for Infra pages if you want :P

I'll need back this weekend. Had a sorely needed time off.

I'll be back this weekend. Had a sorely needed time off.

I'll try to be good and regularly attend meetings again.

And, in some cases, it includes a lot of persuasion is needed with SIGs, e.g. ARM

And it would be good if we had a plan, rather than just rushing in.

Enjoy the vacation, we will be here when you're ready 😊

The wiki thing is still on my agenda. It's just too tedious to do in one go.

It really is. But if anyone wants to go, this issue naturally splits into a ton of tiny tasks, you can just go yeet a page or two at a time and it still helps

Perhaps we should draw up a list of which wiki pages need to be ported (and which questions or problems arise)

I don't think it's necessary. 99% of pages are obviously obsolete.

!hi

I would like to offer a flame thrower

I'm trying to work out what exactly needs doing... I am happy for lots of tiny tasks... I often find that I only have a few minutes or so available and if I can use those few minutes to do something useful, I would be glad to help. I am just on clear as to which pages we edit like this...

That is the adequate instrument to deal with the wiki pages.

I'm trying to work out what exactly needs doing... I am happy for lots of tiny tasks... I often find that I only have a few minutes or so available and if I can use those few minutes to do something useful, I would be glad to help. I am just not clear as to which pages we edit like this...

I thought we were looking at Docs Team docs specifically?

I haven't found a single page so far that seems worth preserving.

I thought we were looking at Docs Team Fedora Wiki pages specifically?

Justin Wheeler: Yes, as an example the ARM pages.

ah... so kind of just a judgement call when you review?

All pages listed here: https://fedoraproject.org/wiki/Category:Docs_Project

They are docs!

If the pages are just Docs Team pages that live in the Wiki, I think we can redirect as we go

But that's not Docs Team, that's the ARM WG/SIG, right?

Yes, that's what I basically do.

Yeah, this isn't so many pages left actually

But is that list complete??????

Those are all subcategories :P

(time check: 7m left)

Oh haaaaaah

Don't be fooled by that index. There's plenty of sub-pages.

Now I'm afraid

Afraid you will be!

Be afraid, very very afraid

The issue we're talking about is specifically about the Docs Project category on the wiki. There are others that need the same treatment but those are separate issues, we're trying to clean up our own backyard right now

Wow!, just clicked on Documentation.

So the list is complete by definition, if it's not in that category, we don't care at the moment

Yoda of wiki am I. Tons of pages edit you need!

The docs category is plenty of work as it is. We should define cleaning it the main milestone.

My brain went to Spaceballs

Yeah and some of the subcategories have their own subcategories

If we make the wiki scope too big, it'll be a black hole eating too much work.

I forgot whether I put the redirect wiki code into the issue for this milestone.

I got it from [@jflory7:fedora.im](https://matrix.to/#/@jflory7:fedora.im) so if anyone wants to help, he'll be able to send you the code. 😆

^ there

Cheers, mate.

All right, we're almost out of time. I had another thing on the agenda but we'll have to discuss this in our channel

Thanks [@pbokoc:fedora.im](https://matrix.to/#/@pbokoc:fedora.im) for saving me from action items 🤣

Thanks for chairing today!

I'd keep an eye on your email. LOl

And that's it! Thank you for coming everyone, and I'll see you in #docs:fedoraproject.org