<@jflory7:fedora.im>
13:04:12
!startmeeting Fedora Docs Team meeting - 2026-04-07
<@pg-tips:fedora.im>
13:04:12
!hi
<@meetbot:fedora.im>
13:04:12
Meeting started at 2026-04-07 13:04:12 UTC
<@meetbot:fedora.im>
13:04:13
The Meeting name is 'Fedora Docs Team meeting - 2026-04-07'
<@jflory7:fedora.im>
13:04:16
!meetingname docs
<@meetbot:fedora.im>
13:04:16
The Meeting Name is now docs
<@zodbot:fedora.im>
13:04:20
P G (pg-tips)
<@jflory7:fedora.im>
13:04:25
!topic Roll Call & Hello's
<@jflory7:fedora.im>
13:04:26
!hi
<@zodbot:fedora.im>
13:04:31
Justin Wheeler (jflory7) - he / him / his
<@jflory7:fedora.im>
13:04:36
Good morning, folks! Or good `$TIME_OF_DAY` π
<@jflory7:fedora.im>
13:04:42
Who all is here?
<@pbokoc:fedora.im>
13:04:42
!hi
<@zodbot:fedora.im>
13:04:43
Petr BokoΔ (pbokoc)
<@jflory7:fedora.im>
13:04:44
!group members docs
<@zodbot:fedora.im>
13:04:46
Members of docs: augenauf, copperi, Alix Andrieu, hank L, Stephen Snow, jflory7 (@jflory7:fedora.im, @fca:fedoraproject.org), Jean-Baptiste Holcroft, Kevin Fenzi, laubersm, Anushka Jain, Cornelius Emase, Mateus Rodrigues Costa, Matthew Miller, mjahoda, mpduty, Petr BokoΔ, Peter Boy, P G, pmkovar, Christopher Klooz, sarkajana, sclark, Shaun McCance, Sumantro Mukherjee, Freya Gustavsson, x3mboy, Zach Oglesby
<@cstrauf:fedora.im>
13:05:13
π
<@hricky:fedora.im>
13:05:21
!hi
<@zodbot:fedora.im>
13:05:22
Hristo Marinov (hricky) - he / him / his
<@klavier:fedora.im>
13:05:27
hi
<@cstrauf:fedora.im>
13:05:34
!hi
<@zodbot:fedora.im>
13:05:35
Christian Strauf (cstrauf)
<@jflory7:fedora.im>
13:06:01
> - **Open Floor:** Anything else top of mind.
<@jflory7:fedora.im>
13:06:01
While folks are arriving, here is the TBD agenda. If anyone wants to suggest another topic, please do so now!
<@jflory7:fedora.im>
13:06:01
> - **Forgejo Migration Status:** Let's touch base on the `pages` repo migration.
<@jflory7:fedora.im>
13:06:01
> - **Quick Docs?**
<@jflory7:fedora.im>
13:06:01
<@jflory7:fedora.im>
13:06:01
> - **New member tickets.**
<@cstrauf:fedora.im>
13:06:27
- How to proceed with Beginner's Guide?
<@klavier:fedora.im>
13:06:28
!hi
<@jflory7:fedora.im>
13:06:28
Wow, I love to see a busy meeting π Good to see ya folks!
<@zodbot:fedora.im>
13:06:29
Test Lab (klavier)
<@jflory7:fedora.im>
13:06:31
I hope everyone is well.
<@jflory7:fedora.im>
13:06:37
Yes, good one! ποΈ
<@jflory7:fedora.im>
13:07:19
Let's get to the news and announcements, and folks can start to drop things in π
<@theprogram:fedora.im>
13:07:35
!hi
<@zodbot:fedora.im>
13:07:36
Mat H (theprogram)
<@jflory7:fedora.im>
13:07:56
!info Present: @jflory7, @pg-tips, @pbokoc, @hricky, @cstrauf, @klavier, @theprogram
<@jflory7:fedora.im>
13:08:09
Hank: BTW, what time is it for you right now? Are you in Korea now?
<@jflory7:fedora.im>
13:08:14
!topic Team news & announcements
<@jflory7:fedora.im>
13:08:24
Any folks have some news, announcements, or interesting things to share?
<@jflory7:fedora.im>
13:08:30
Please write it in with `!info`!
<@jflory7:fedora.im>
13:08:33
I have a coupleβ¦
<@klavier:fedora.im>
13:08:37
22:10 relaxing
<@jflory7:fedora.im>
13:09:22
A very good evening to you π
<@jflory7:fedora.im>
13:10:30
!info Early in March, @jflory7 attended SCaLE 23x in Pasadena, California. I presented about the Fedora Docs community and asked attendees to role-play different parts of the Fedora Docs community. I have notes and a write-up that I need to share more widely.
<@jflory7:fedora.im>
13:10:44
I could have sworn I made a public post somewhere about it with my summary π€
<@jflory7:fedora.im>
13:10:52
But it is too early for me to dig that up just yet, heheh
<@jflory7:fedora.im>
13:11:18
!info The Beginner's Guide was created last week, after the work @cstrauf and @theprogram put in to assemble it.
<@jflory7:fedora.im>
13:11:24
!link https://forge.fedoraproject.org/docs/docs-beginners
<@jflory7:fedora.im>
13:11:35
Anyone have anything else?
<@jflory7:fedora.im>
13:11:45
See anything new or interesting out there, Fedora or otherwise? π
<@pbokoc:fedora.im>
13:11:48
Yeah, I still owe you guys a review
<@pbokoc:fedora.im>
13:12:15
I'll get to it soon, but I need to get on writing F44 relnotes
<@cstrauf:fedora.im>
13:12:32
Thanks for the repo, Petr Bokoc, it helped to put the guide into its final format.
<@hricky:fedora.im>
13:12:56
I will also like to suggest some styling improvements.
<@jflory7:fedora.im>
13:13:12
Luckily, we will definitely discuss this ticket today!
<@jflory7:fedora.im>
13:13:18
If nothing else, let's get into the main discussion.
<@jflory7:fedora.im>
13:13:33
!topic Tickets & Main Work Discussion
<@cstrauf:fedora.im>
13:13:41
If possible, please attach issues to the guide's repo so that we can document changes and requests.
<@jflory7:fedora.im>
13:14:03
!info Topic 1: New member tickets
<@jflory7:fedora.im>
13:14:07
!info Topic 2: Beginner's Guide
<@jflory7:fedora.im>
13:14:09
!info Topic 3: Forgejo Migration Status: Let's touch base on the pages repo migration.
<@jflory7:fedora.im>
13:14:13
!info Topic 4: Quick Docs?
<@jflory7:fedora.im>
13:14:16
!info Topic 5: Open Floor: Anything else top of mind.
<@jflory7:fedora.im>
13:14:24
!topic New member tickets
<@jflory7:fedora.im>
13:14:30
OK, let's start with something fun and something fast!
<@jflory7:fedora.im>
13:14:52
We have some new team member requests! https://forge.fedoraproject.org/docs/tickets/issues?q=&type=all&state=open&labels=4418&milestone=0&assignee=0&poster=0
<@jflory7:fedora.im>
13:15:52
So, while the tickets were opened three days ago, I believe the rule we have adopted is seven days time. But I see lots of affirmative votes here π
<@jflory7:fedora.im>
13:16:16
I wanted to let folks know that MatH, Christian Strauf, and Hristo Marinov have official tickets opened, and I encourage all current team members to take a look!
<@jflory7:fedora.im>
13:16:35
I don't think this is really _new_ but I like that the new member template is already getting used π
<@pbokoc:fedora.im>
13:16:42
Yeah, I set expiration dates for the existing tickets, mostly just to see what Forgejo does when the time is up, like what kind of a notification does it give
<@jflory7:fedora.im>
13:16:45
!link https://forge.fedoraproject.org/docs/tickets/issues/23
<@jflory7:fedora.im>
13:16:48
!link https://forge.fedoraproject.org/docs/tickets/issues/24
<@jflory7:fedora.im>
13:16:50
!link https://forge.fedoraproject.org/docs/tickets/issues/25
<@theprogram:fedora.im>
13:16:52
The templates are working well.
<@jflory7:fedora.im>
13:17:03
I'm curious about that too!
<@hricky:fedora.im>
13:17:12
The template is really useful.
<@pbokoc:fedora.im>
13:17:20
They all have at least 3 +1s I believe, so unless someone comes out with some scandalous revelation, I'll add everyone on Friday
<@jflory7:fedora.im>
13:17:50
[@pbokoc:fedora.im](https://matrix.to/#/@pbokoc:fedora.im)++
<@zodbot:fedora.im>
13:17:53
jflory7 has already given cookies to pbokoc during the F43 timeframe
<@jflory7:fedora.im>
13:18:35
!info Per the agreed rules, after seven days, the tickets can be fully approved and new members added to the FAS group.
<@venefilyn:matrix.org>
13:18:55
!hi
<@zodbot:fedora.im>
13:18:57
Freya Gustavsson (venefilyn) - they / them / theirs or she / her / hers
<@theprogram:fedora.im>
13:19:08
Sweet. Where are the rules kept (for future info)
<@jonashub:fedora.im>
13:19:08
!hi
<@zodbot:fedora.im>
13:19:10
JonΓ‘Ε‘ HubenΓ½ (jonashub) - he / him / his
<@venefilyn:matrix.org>
13:19:15
How many votes do we need to add members? 3?
<@pbokoc:fedora.im>
13:19:25
Yes, 3
<@egret:fedora.im>
13:19:30
!hi
<@jflory7:fedora.im>
13:19:30
!info The new member nomination form seems to be working well! If you are contributing to the Fedora Docs Team already but are not formally part of the group, please take a look at the form and consider nominating yourself.
<@zodbot:fedora.im>
13:19:33
Eli Ridge (egret)
<@jflory7:fedora.im>
13:19:37
At least three votes in seven days.
<@jflory7:fedora.im>
13:20:11
!info +Present: @venefilyn @jonashub @egret
<@jflory7:fedora.im>
13:20:15
Hey folks!
<@jflory7:fedora.im>
13:20:30
[@jonashub:fedora.im](https://matrix.to/#/@jonashub:fedora.im) It's my first time seeing you around here. Welcome!
<@jonashub:fedora.im>
13:20:56
Hey, thank you!
<@jflory7:fedora.im>
13:20:58
OK, this was mostly a FYI. Let's get to a bigger topic! And try to keep this to 15 minutes ideally
<@jflory7:fedora.im>
13:21:05
!topic Beginner's Guide
<@jflory7:fedora.im>
13:21:21
[@cstrauf:fedora.im](https://matrix.to/#/@cstrauf:fedora.im) [@theprogram:fedora.im](https://matrix.to/#/@theprogram:fedora.im) Okay, this one is all y'all! The floor is yours.
<@cstrauf:fedora.im>
13:22:49
Cheers! The guide has been converted to asciidoc, Antora build works. What we're looking for are people who'd be willing to fact check. We think that the guide should be OK but it never hurts to get more input. The second question is how an where it should be published.
<@cstrauf:fedora.im>
13:23:28
We've "beta tested" it with new users, too. But finding new users that are also willing to beta test the guide is not that easy. ;)
<@theprogram:fedora.im>
13:23:43
Petr suggested linking to the front page of docs, which I like
<@theprogram:fedora.im>
13:24:02
I'm interested in Hristo's ideas about fromatting / styling
<@pbokoc:fedora.im>
13:24:16
Well, linking from, not to :) But yeah, since this is aimed at completely new users, I think it's best to display it front and center instead of hiding it in a subcategory
<@theprogram:fedora.im>
13:24:20
I'm interested in Hristo's ideas about formatting / styling
<@venefilyn:matrix.org>
13:24:51
Agreed, front page of docs seems like a good place but there are a lot of stuff there now (though refactoring that seems like a different issue)
<@theprogram:fedora.im>
13:24:56
Petr suggested linking to (I mean from) the front page of docs, which I like
<@klavier:fedora.im>
13:25:17
Instead of: "I recommend that you use Git for version control."
<@klavier:fedora.im>
13:25:17
Just circling back on this to see if anyone has thoughts on De-personalization like;
<@klavier:fedora.im>
13:25:17
Use: "Git is the recommended tool for version control."
<@jflory7:fedora.im>
13:25:20
Is it on docs.fp.o yet?
<@hricky:fedora.im>
13:25:22
I'll open an issue with the suggestions.
<@pbokoc:fedora.im>
13:25:36
Yeah, we actually have an issue for that :) https://forge.fedoraproject.org/docs/tickets/issues/6
<@jflory7:fedora.im>
13:25:42
What point in the content development are you at? What would you say is the biggest call-to-action right now?
<@venefilyn:matrix.org>
13:25:49
Should we put the actual page under Docs Team?
<@cstrauf:fedora.im>
13:25:49
No, I don't think so.
<@jflory7:fedora.im>
13:25:53
Yep, was going to mention that too!
<@pbokoc:fedora.im>
13:25:57
Not yet, I want to give it a look before I publish it.
<@theprogram:fedora.im>
13:26:00
I don't think we'll change that for this Beginnger Guide, but you are certainly correct for instructional docs.
<@theprogram:fedora.im>
13:26:36
The point of the language here is that it is personal.
<@jflory7:fedora.im>
13:26:38
I think generally, we do not want to write in the first-person
<@cstrauf:fedora.im>
13:26:53
I'd say we're good to go for publishing if people don't find any major issues within 7 days.
<@jflory7:fedora.im>
13:27:08
But first-person seems personal individually
<@jflory7:fedora.im>
13:27:23
I'm not going to block on it, but writing in first-person feels odd and stylistically different to me
<@jflory7:fedora.im>
13:27:27
From everything else we publish
<@cstrauf:fedora.im>
13:27:29
There's no first person in the BG.
<@jflory7:fedora.im>
13:27:41
Ah, okay, I was confused by Hank's comment
<@cstrauf:fedora.im>
13:28:00
There's direct addressing of the reader though due to the special nature of the document. We don't think this style is recommended outside the BG.
<@theprogram:fedora.im>
13:28:27
I believe we use the royal 'we'
<@cstrauf:fedora.im>
13:28:34
We do. :)
<@jflory7:fedora.im>
13:28:35
Second-person and third-person are fine to me
<@jflory7:fedora.im>
13:28:49
I see what you did there π
<@pg-tips:fedora.im>
13:28:52
https://docs.fedoraproject.org/en-US/quick-docs/getting-started-guide/ - this uses first-person "we" several times in the intro
<@klavier:fedora.im>
13:29:06
Appreciate the perspective. Itβs a good reminder of the stylistic split we could maintain consistently.
<@pg-tips:fedora.im>
13:29:08
Do you feel differently about first-person singular vs plural?
<@jflory7:fedora.im>
13:29:46
Christian Strauf, MatH: One thing that might be good for the meeting minutes and the summary is if y'all write a `!info` about your progress, where things are, and maybe a !halp` on where you need some more eyes and hands.
<@cstrauf:fedora.im>
13:29:47
We did in the BG because "we = Fedora Project" makes sense, I as in "I = author" not so much.
<@pboy:fedora.im>
13:30:11
!hi
<@zodbot:fedora.im>
13:30:14
Peter Boy (pboy)
<@jflory7:fedora.im>
13:30:23
!info Currently, the Beginner's Guide is not yet published on docs.fedoraproject.org. It is pending a review from @pbokoc before it gets added to the Antora builder repo.
<@pboy:fedora.im>
13:30:26
sorry beeing late
<@jflory7:fedora.im>
13:30:42
Seems like "we" are fine with "we" and just not "I" π
<@jflory7:fedora.im>
13:30:59
!info +Present: @pboy
<@cstrauf:fedora.im>
13:31:06
MatH: To avoid dupes, would you write the `!info` so that we avoid dupes? Cheers, mate!
<@jflory7:fedora.im>
13:31:11
Peter Boy (ServerWG, Docs): No worries! Welcome! π We are on the Beginner's Guide now.
<@jonashub:fedora.im>
13:31:43
Hey @[Peter Boy (ServerWG, Docs)]
<@cstrauf:fedora.im>
13:31:56
MatH: To avoid dupes, would you write the `!info`? Cheers, mate!
<@cstrauf:fedora.im>
13:32:30
Would you guys say that a 7 days proof-reading period is sufficient? I think it should be.
<@jflory7:fedora.im>
13:32:47
You mean before going up on docs.fp.o?
<@cstrauf:fedora.im>
13:33:05
Yes. I think it makes sense not to "open end" the proof-reading period.
<@cstrauf:fedora.im>
13:33:14
Unless there're major problems.
<@jflory7:fedora.im>
13:33:17
Agreed, deadlines are good π
<@jflory7:fedora.im>
13:33:35
I confess I will not have much capacity to review the content closely, but I think there are folks here who can help out with that.
<@klavier:fedora.im>
13:33:39
The title "Beginner's Guide to Fedora Forge" could be worded in an engaging tone like;
<@klavier:fedora.im>
13:33:39
If you're keen to stick to "Beginners", that's fine, too.
<@klavier:fedora.im>
13:33:39
<@klavier:fedora.im>
13:33:39
- Introduction to Fedora Forge Workflows
<@klavier:fedora.im>
13:33:39
- Fedora Forge Getting Started Guide
<@jflory7:fedora.im>
13:33:44
Petr Bokoc: Is next Monday a realistic deadline for you?
<@pbokoc:fedora.im>
13:33:55
Yeah that should be fine
<@theprogram:fedora.im>
13:34:06
We as Docs SIG agree that the language used is suitable. We agree that the guide should be linked from the fron page of Fedora Docs website in order to help more people install and learn about Fedora.
<@theprogram:fedora.im>
13:34:06
Otherwise we are ready to go live after a review from Petr Bokoc
<@theprogram:fedora.im>
13:34:06
SIG members and others are welcome to indicate any factual errors or ommisions.
<@theprogram:fedora.im>
13:34:06
Hristo will make some suggestions re: styling and formatting.
<@theprogram:fedora.im>
13:34:06
!info Beginners Guide to Fedora is uploaded to Docs in the beginners-guide repo.
<@pboy:fedora.im>
13:34:08
Is it just "proofreading", i.e. spelling and wording, or does it include content related questions / comments?
<@cstrauf:fedora.im>
13:34:09
The guide is not for forge, it's for the distro user.
<@pg-tips:fedora.im>
13:34:22
are we talking about two different docs here?
<@jflory7:fedora.im>
13:34:36
MatH: Ah, the multi-line messages do not work with a single `!info` π
<@jflory7:fedora.im>
13:34:55
P G: I am wondering the same thing, not sure if Hank is discussing the Linux beginner's guide or something about Fedora Forge?
<@cstrauf:fedora.im>
13:34:55
I think that Hank might be talking about Eli Ridge's onboarding guide.
<@pg-tips:fedora.im>
13:35:13
that's how I read it too
<@venefilyn:matrix.org>
13:35:28
What about just "(Introduction|Introdoctory guide) to Fedora Forge"?
<@cstrauf:fedora.im>
13:35:59
To clarify: the current topic is about https://forge.fedoraproject.org/docs/docs-beginners
<@klavier:fedora.im>
13:36:01
ok for fresshh eye's perspective, I lost the context. that's ok
<@jflory7:fedora.im>
13:36:13
!info @theprogram: We as Docs Team agree that the language used is suitable. We agree that the guide should be linked from the from page of Fedora Docs website in order to help more people install and learn about Fedora.
<@jflory7:fedora.im>
13:36:18
!info @theprogram: @hricky will make some suggestions, RE: styling and formatting.
<@cstrauf:fedora.im>
13:36:19
No problem. :)
<@theprogram:fedora.im>
13:36:20
!info We as Docs SIG agree that the language used in the beginners guide is suitable. We agree that the guide should be linked from the fron page of Fedora Docs website in order to help more people install and learn about Fedora.
<@jflory7:fedora.im>
13:36:23
!action @hricky Share comments on Beginner's Guide content with @cstrauf and @theprogram
<@jflory7:fedora.im>
13:36:26
!info @theprogram: SIG members and others are welcome to indicate any factual errors or ommisions. Otherwise we are ready to go live after a review from Petr Bokoc
<@jflory7:fedora.im>
13:36:38
MatH: Ah, sorry, I ninja'd you π π₯·
<@theprogram:fedora.im>
13:37:16
!info Hristo will make some suggestions for the Fedora Beginners Guide re: styling and formatting. SIG members and others are welcome to indicate any factual errors or ommisions. Otherwise we are ready to go live after a review from Petr Bokoc.
<@jflory7:fedora.im>
13:37:29
!halp Blocked on editing the front page until the "pages" repository is moved from GitLab to Forgejo?
<@pbokoc:fedora.im>
13:37:55
Oh yeah about that
<@pbokoc:fedora.im>
13:38:09
I didn't notice that earlier - but the pages repo is actually migrated, has been for a long time
<@jflory7:fedora.im>
13:38:23
Oh!
<@pbokoc:fedora.im>
13:38:27
I think what we actually wanted to discuss was renaming docs-fp-o to something more descriptive
<@jflory7:fedora.im>
13:38:44
Well, is that a good transition to the next topic?
<@pbokoc:fedora.im>
13:38:54
Yeah :)
<@jflory7:fedora.im>
13:39:15
MatH, Christian Strauf: I think we have a good timeline laid out. Do you feel like you have next steps? Oh, and where should people add comments and feedback?
<@jflory7:fedora.im>
13:39:35
!link https://forge.fedoraproject.org/docs/tickets/issues/8
<@jflory7:fedora.im>
13:39:40
I guess there makes sense? π
<@cstrauf:fedora.im>
13:40:08
We can discuss comments on #docs:fedoraproject.org and then we can add issues that need work to the repo of the BG directly.
<@jflory7:fedora.im>
13:40:26
!action @docs Add any feedback on the Beginner's Guide in the pre-publishing stage on Ticket #8 for the Docs Team or in the Matrix room, #docs:fedoraproject.org.
<@jflory7:fedora.im>
13:40:35
Sounds good!
<@cstrauf:fedora.im>
13:40:59
Directly in the repo will help if issues need branching and changelogs etc.
<@jflory7:fedora.im>
13:41:03
I think once the guide is up on docs.fp.o, we can close the ticket. I don't want to block on the front-page stuff, because we have other tickets to track those changes
<@jflory7:fedora.im>
13:41:31
!info Once the Beginner's Guide is published, Docs Team Ticket #8 will be closed, and all future bugs/requests/feedback should be added as new issues directly on the Beginner's Guide repo on Forgejo.
<@jflory7:fedora.im>
13:41:34
Sound good?
<@jflory7:fedora.im>
13:41:37
Anything else?
<@jflory7:fedora.im>
13:41:43
β±οΈ
<@jflory7:fedora.im>
13:42:26
Tick, tick, tickβ¦
<@jflory7:fedora.im>
13:42:33
_**boom**_
<@jflory7:fedora.im>
13:42:35
π₯
<@jflory7:fedora.im>
13:42:40
!topic Forgejo Migration Status: Let's touch base on the pages repo migration.
<@jflory7:fedora.im>
13:42:48
Petr Bokoc: Want to drop a `!info` in here?
<@jflory7:fedora.im>
13:42:59
Not sure if this will be an _update_ or a _discussion_
<@jflory7:fedora.im>
13:43:22
Overall, seems like things are going steady
<@jflory7:fedora.im>
13:43:33
Let me see if I can do a quick hack to see how many Pagure repos are still being published
<@cstrauf:fedora.im>
13:44:01
Sorry, need to run back to work.
<@jflory7:fedora.im>
13:44:12
Christian Strauf: No worries, thanks for being here!
<@jflory7:fedora.im>
13:44:14
See ya next time
<@theprogram:fedora.im>
13:44:15
later!
<@cstrauf:fedora.im>
13:44:19
Cheers!
<@jflory7:fedora.im>
13:44:49
22 Pagure.io repos still exist on docs.fp.o
<@jflory7:fedora.im>
13:45:01
184: - url: https://pagure.io/fedora-workstation.git
<@jflory7:fedora.im>
13:45:01
171: - url: https://pagure.io/i3-sig/docs.git
<@jflory7:fedora.im>
13:45:01
192: - url: https://pagure.io/defensive-coding-guide.git
<@jflory7:fedora.im>
13:45:01
```
<@jflory7:fedora.im>
13:45:01
112: - url: https://pagure.io/Fedora-Council/council-docs.git
<@jflory7:fedora.im>
13:45:01
115: - url: https://pagure.io/Fedora-Council/council-docs.git
<@jflory7:fedora.im>
13:45:01
118: - url: https://pagure.io/fedora-docs/modularity.git
<@jflory7:fedora.im>
13:45:01
119: - url: https://pagure.io/fedora-docs/package-maintainer-docs.git
<@jflory7:fedora.im>
13:45:01
125: - url: https://pagure.io/fedora-docs/flatpak.git
<@jflory7:fedora.im>
13:45:01
128: - url: https://pagure.io/packaging-committee.git
<@jflory7:fedora.im>
13:45:01
132: - url: https://pagure.io/fesco/fesco-docs.git
<@jflory7:fedora.im>
13:45:01
142: - url: https://pagure.io/fedora-docs/remix-building.git
<@jflory7:fedora.im>
13:45:01
147: - url: https://pagure.io/sig-teleirc/infrastructure.git
<@jflory7:fedora.im>
13:45:01
153: - url: https://pagure.io/fedora-magazine.git
<@jflory7:fedora.im>
13:45:01
154: - url: https://pagure.io/minimization.git
<@jflory7:fedora.im>
13:45:01
157: - url: https://pagure.io/cpe/rawhide-gating-docs.git
<@jflory7:fedora.im>
13:45:01
158: - url: https://pagure.io/cpe/docs.git
<@jflory7:fedora.im>
13:45:01
167: - url: https://pagure.io/fedora-docs/localization.git
<@jflory7:fedora.im>
13:45:01
174: - url: https://pagure.io/gaming/documentation.git
<@jflory7:fedora.im>
13:45:01
187: - url: https://pagure.io/fedora-workstation.git
<@jflory7:fedora.im>
13:45:01
```
<@jflory7:fedora.im>
13:45:01
213: - url: https://pagure.io/fedora-cloud/docs-site.git
<@jflory7:fedora.im>
13:45:01
201: - url: https://pagure.io/fedora-reproducible-builds/docs-site.git
<@jflory7:fedora.im>
13:45:01
199: - url: https://pagure.io/fedora-asahi/docs-site.git
<@pbokoc:fedora.im>
13:45:15
There's a couple dupes in there, too
<@jflory7:fedora.im>
13:45:25
Yeah, they serve multiple pages from one repo
<@pbokoc:fedora.im>
13:45:34
2 of them, if my eyes don't deceive me. So 20 unique repos.
<@jflory7:fedora.im>
13:45:39
e.g., Council docs serves `/project/` and `/council/` from the same repo
<@pbokoc:fedora.im>
13:46:05
!info Forge migration status: Almost all Gitlab repos are migrated, 3 unpublished repos need to either just be deleted or have their contents archived, + the UI repo needs to move but we need a forgejo runner first. @pbokoc is on it.
<@jflory7:fedora.im>
13:46:19
Some of these could probably be droppedβ¦ like I don't think the TeleIRC SIG is really much of a thing anymore since we don't use IRC or Telegram these daysβ¦ π
<@pboy:fedora.im>
13:46:47
The number brings me to the questions: Do we know, if we can create folders / subgroup of repos to get a cleaner organisation?
<@jflory7:fedora.im>
13:47:07
Peter Boy (ServerWG, Docs): Could you give an example?
<@theprogram:fedora.im>
13:47:17
Defensive Coding Guide seems rather out of date
<@pbokoc:fedora.im>
13:47:42
!info 20 currently published repos on Pagure still need to be migrated. There are also some old repos in Pagure that aren't currently published but should be preserved. The plan is to migrate them and immediately archive them in Forge, and either we'll pick them up later or not.
<@pboy:fedora.im>
13:47:42
Yes, e.g archive for repos we have to keep for hjistorical reasons.
<@jflory7:fedora.im>
13:47:47
Maybe we need to start finding owners/maintainers of these pending docs, because if nobody steps up to move them, their overall value might be low or nonexistent in 2026
<@pboy:fedora.im>
13:47:47
Or extern
<@pboy:fedora.im>
13:48:07
Or external for repos maintanin by other groujps
<@pbokoc:fedora.im>
13:48:33
Yeah, that's the plan, I'm gonna start doing some detective work. I'll have to get to it a bit later though, F44 is coming soon and I need to write release notes this week.
<@jflory7:fedora.im>
13:48:37
Peter Boy (ServerWG, Docs): Ah, like in `forge.fp.o/docs`. Well, we do not have to move everything into Forgejo I suppose. There is a way to archive repos, and then to filter by non-archived repos only, but I don't think this is what you are looking for either
<@jflory7:fedora.im>
13:49:13
Well, the Pagure.io deadline is Flock, so there is some buffer between F44 and the final countdown 3οΈβ£ 2οΈβ£ 1οΈβ£
<@pbokoc:fedora.im>
13:49:27
Yup :)
<@pboy:fedora.im>
13:49:39
Filter would be one way. Pagure can do grouping or folders, and gitlab can, too.
<@jflory7:fedora.im>
13:50:05
I don't think Pagure could ever do folders π€
<@jflory7:fedora.im>
13:50:24
Or if it can, it took me ten years too long to figure out that was a feature π
<@pboy:fedora.im>
13:50:44
Pagure can!
<@pboy:fedora.im>
13:51:03
One example is the pagure docs structure. (the old one)
<@jflory7:fedora.im>
13:51:51
Maybe we are using the word "folder" to mean different things, but there is not a way to make folders on Pagure like you can on GitLab. You can create multiple teams/groups and organize things that way, but it is not a folder within a single Pagure group
<@jflory7:fedora.im>
13:52:08
!info Some detective work is needed to determine if the remaining 20 repositories on Pagure.io need to be migrated, or if they even still have a maintainer. @pbokoc will investigate further after the F44 release but before Flock.
<@pboy:fedora.im>
13:52:34
Well. c
<@jflory7:fedora.im>
13:52:37
!info QUESTION: Do we migrate archived repos to Forgejo at all? Or do we have a Fedora Docs "graveyard" for archived, unpublished content? Where should this go? More discussion is needed.
<@jflory7:fedora.im>
13:53:20
Time check: Seven minutes left
<@pboy:fedora.im>
13:53:24
Well, the repos we have to keep for historical reasons don't have an active maintainer anymore. Otherwise they wouldn't be historical, I guiess.
<@jflory7:fedora.im>
13:53:55
I am mixed minds about whether we should move everything just because Pagure.io is going away or not
<@jflory7:fedora.im>
13:54:05
Like those TeleIRC SIG docs that we made ages ago
<@jflory7:fedora.im>
13:54:18
It was me and one other person working on those, and it is now defunct
<@theprogram:fedora.im>
13:54:19
exterminate
<@pbokoc:fedora.im>
13:54:54
Right at the top of the "my repos" in pagure there's an accessibility guide that's still written in docbook, latest commit is by Pete Travis 10 years ago :D
<@theprogram:fedora.im>
13:55:00
If in doubt, leave it out
<@jflory7:fedora.im>
13:55:09
ππ
<@jflory7:fedora.im>
13:55:25
OK, uhhh, no Docbook in Forge or I might cry π€£
<@jflory7:fedora.im>
13:56:10
I'm leaning this way, that if nobody raises a hand to save content, then it is asking quite a lot of us to be archivist superheroes for little to no gain
<@pbokoc:fedora.im>
13:56:13
Hey, I liked docbook! It actually caused an error if you screwed up instead of causing some utter insanity on the other end of the document! :D
<@jflory7:fedora.im>
13:56:21
Heheh π
<@jflory7:fedora.im>
13:56:57
!info We likely need a clear proposal next on what to do with older content on Pagure.io and what our plan, as Docs Team, will be ahead of the Pagure.io sunset at Flock 2026.
<@jflory7:fedora.im>
13:57:07
!topic Open floor
<@jflory7:fedora.im>
13:57:13
OK, sorry for the abrupt topic changeβ
<@klavier:fedora.im>
13:57:18
can we archive dormant repos?
<@jflory7:fedora.im>
13:57:20
But we have 180 seconds or less left in this meeting π
<@jflory7:fedora.im>
13:57:29
Do folks have anything to bring up that we _didn't_ cover earlier?
<@egret:fedora.im>
13:57:55
F44 sentive question. Communishift namespace for draft sharing
<@jflory7:fedora.im>
13:57:56
Hank: We have done so for a few, but I think the concern is if we have 50 repos on Fedora Forge, and 32 of them are archived, it could make our useful, valuable content harder to discover
<@jflory7:fedora.im>
13:58:11
Eli Ridge: Oh, what's this? π
<@egret:fedora.im>
13:58:31
If I donβt ask, it will get removed with f44
<@klavier:fedora.im>
13:58:33
Tough.
<@jflory7:fedora.im>
13:58:43
Hank: Here is an example: https://forge.fedoraproject.org/docs/contributors-guide
<@ahmedalmeleh:matrix.org>
13:59:16
I saw that pagure notice will go soon I knew force was around recently
<@jflory7:fedora.im>
13:59:29
Eli Ridge: It could just be early for me, but I am missing context on this CommuniShift topic!
<@theprogram:fedora.im>
13:59:32
Getting rid of the cruft is really important in my view, clean house to make the diamonds we have shine
<@jflory7:fedora.im>
13:59:48
Oh hey Ahmed Almeleh, welcome π
<@klavier:fedora.im>
14:00:08
hitory lives on here. Another chapter bbegins with forgejo
<@pg-tips:fedora.im>
14:00:13
Right, and don't expose outdated and misleading stuff to users
<@pbokoc:fedora.im>
14:00:59
We could get a "docs-archives" org separate from docs but with same ownership/access, I suppose. That would be the cleanest way to do it.
<@jflory7:fedora.im>
14:01:00
!info Not a full consensus, but some discussion that we likely only want active, maintained docs to migrate to the forge.fedoraproject.org/docs organization. Discoverability is very important and we don't want to direct users and contributors to dead content.
<@jflory7:fedora.im>
14:01:33
Petr Bokoc: I'm not opposed to that, but only if we truly think it is in the benefit of the Fedora Docs Team to keep copies of everything that we will drop from Antora later
<@jflory7:fedora.im>
14:01:44
Because that is definitely real work for someone to do π
<@theprogram:fedora.im>
14:02:08
I think we submit archives pages to Archive.org and leave that up to them
<@pbokoc:fedora.im>
14:02:16
Yeah, that's the question. I'm a bit of a data hoarder myself so I'm for preserving them, but we'll need to discuss that further. It's not a super pressing issue, either.
<@jflory7:fedora.im>
14:02:22
Eli Ridge: So, not sure what's up with the CommuniShift topic, but if it is urgent, let's talk in #docs:fedoraproject.org and make sure you get this sorted!
<@jflory7:fedora.im>
14:02:32
With that folks, we need to yield the room!
<@pboy:fedora.im>
14:02:34
Maybe we shoud another org item: docs-graveyard, if we can't create foiders or groups.
<@jflory7:fedora.im>
14:02:35
Our time is expired.
<@jflory7:fedora.im>
14:02:39
Thanks so much folks for being here!
<@jflory7:fedora.im>
14:02:47
It was an active and lively meeting π
<@jflory7:fedora.im>
14:02:49
I appreciate y'all!
<@pbokoc:fedora.im>
14:02:55
"docs-tomb" heheh
<@jflory7:fedora.im>
14:02:57
Have a great week ahead π
<@jflory7:fedora.im>
14:02:58
!endmeeting