Fedora Docs Team Meeting (2026-10-06)

Project Discussion
1

Hello everyone, this is the agenda for the Docs team meeting on Tuesday, October 6 2026 at 13:00 UTC. The meeting takes place on Matrix, in #meeting. A calendar event is available in Fedocal.

Agenda

AIs from last meeting:

  • hricky: Will adjust the organization-level webhook settings to reduce notification spam from successful builds in the alerts channel. [done]
  • hricky: Will open an issue or start a draft to document the team’s scripts and CI/CD tools in the team documentation. [done]

Announcements

  • We now have a runnerhost repo
  • The Beginner’s Guide has been updated for F45 + new section on backups with Vorta

Today’s agenda:

  • tickets/65 - Where do we put security docs?
  • tickets/66 - We might need to rename most of the components and break every URL ever
  • docs-fp-o/61 - Hristo wants to rename prod to main
  • Justin’s report on Docs Captains?

Plus, if there’s time, the usual “open floor” section where anyone can bring up other topics.

If you want to add a topic to the agenda, comment in this thread.

1 Like
2
  1. Text Log: https://meetbot.fedoraproject.org/meeting_matrix_fedoraproject-org/2026-10-06/fedora-docs-team-meeting-2026-10-06.2026-10-06-13.00.log.txt
  2. HTML Log: Meetbot Logs
  3. Text Minutes: https://meetbot.fedoraproject.org/meeting_matrix_fedoraproject-org/2026-10-06/fedora-docs-team-meeting-2026-10-06.2026-10-06-13.00.txt
  4. HTML Minutes: Meetbot Logs

Key Discussion Points

  • Beginner’s Guide: The guide has been updated for Fedora 45, including a rewritten backups section. The pull request is open for review until the F45 release day.
  • Security Documentation: The team decided to include the new user-focused Security docs within the existing Fedora documentation section (/en-US/fedora/latest/) rather than in Quick Docs or a separate site.
  • Component Consolidation: A major initiative was discussed to unify all documentation modules under a single Antora component name. This will allow for more flexible content arrangement but will change all page URLs. The plan is to tackle this repo by repo, using page aliases to prevent breaking existing links, and test the process on the staging environment first.
  • Staging Environment Changes: The team agreed to move the staging site’s builder repository from the stg branch of the main repo to a dedicated repository on the staging Forge instance (forge.stg.fedoraproject.org).
  • Builder Repo Branching: There is an agreement to rename the prod branch of the main builder repository to main. This will happen in conjunction with the staging environment changes.
  • Docs Captains Update: The AI/ML SIG is making progress on its documentation. A plan is in place to absorb the existing PyTorch and Ollama Quick Docs pages into the new AI/ML docs site, with work expected to be completed in October. Justin Wheeler (jflory7) will serve as the initial captain for this effort.

Action Items

  • @jflory7: Open a tracking ticket for migrating AI/ML SIG docs into a single module in preparation for the component consolidation (per issue #66).
  • @hricky: Set up a copy of the builder repository on the staging Forge and investigate how to direct its output to docs.stg.fedoraproject.org.
  • @pbokoc: Explain to the Security SIG what they need to do to include their user docs module at https://docs.fedoraproject.org/en-US/fedora/latest/.
  • @hricky: Proceed with renaming the prod branch to main in the builder repo.
3
1 Like