Source repository for Fedora Mindshare Committee documentation https://docs.fedoraproject.org/en-US/mindshare-committee/
Find a file
Justin Wheeler 387f2c9293
All checks were successful
Antora docs CI / Build pages (main, mindshare namespace) (pull_request) Has been skipped
Antora docs CI / Build pages (main, mindshare namespace) (push) Successful in 7s
Antora docs CI / Build preview (PR) (pull_request) Successful in 8s
Antora docs CI / Build preview (PR) (push) Has been skipped
📝 docs(events): 2026 refresh of event request guidelines
Refresh the Fedora Mindshare Committee event request guidelines for 2026
and the migration to Forgejo.

Content changes
===============

* Migrate all issue template URLs from GitLab (`?issuable_template=`)
  to Forgejo (`?template=.forgejo/issue_template/`) format.
* Replace stale GitLab `event-requests` repo links: swag requests now
  point to the Mindshare Committee Tickets tracker, reimbursements now
  `xref` the Fedora Reimbursement Requests (FRR) policy page.
* Update the Discourse tag URL in shared attributes to include the right
  Fedora Discussion category with the tag.
* Document that approved tickets receive the `state/approved` label
  instead of a freeform "approved message."
* Better explain what is considered a recognized vote by a Committee
  member.
* Eliminate cross-links to the Advocate Program, which has not been
  reviewed since 2018/2019.
* Provide accepted methods for how to share an event report, making it
  more clear that only these methods are valid.

Antora partial restructuring
=============================

* Strip headers and anchors from all partials so they are plain reusable
  text snippets. Headers and anchors now live in the event request pages
  themselves, giving each page full control over its document hierarchy
  and table of contents.
* Rename partial files to drop the `step0N-*` prefix, using descriptive
  names only (e.g. `open-ticket-small-events.adoc`,
  `committee-vote-medium-events.adoc`, etc.).

Props to @nmilosev for bringing attention to the outdated documentation
and @pbokoc for calling that this would happen some time back.

Assisted-by: Claude Opus 4.6 (1M context)
Signed-off-by: Justin Wheeler <jwheel@redhat.com>
2026-08-14 18:38:42 -04:00
.forgejo/workflows 🐛💚 ci: Fix Antora build that has never passed on Forgejo 2026-07-08 19:18:54 -04:00
modules 📝 docs(events): 2026 refresh of event request guidelines 2026-08-14 18:38:42 -04:00
.gitignore 📝🔨 docsbuilder.sh: Update latest upstream docs dev build script 2025-04-04 13:16:59 -04:00
antora.yml 🏗️ Antora: Create policy module 2023-06-11 15:09:38 +00:00
docsbuilder.sh 🔧 docs: Change Antora Docker Hub image to Fedora Docs Site image 2026-01-15 12:25:02 -05:00
LICENSE.txt 🎉 Initial commit 2023-04-11 16:23:33 -04:00
README.md 📝 docs(README): Fix script start command, update URLs 2026-07-08 16:04:35 -04:00
site.yml 🚚 Update paths and configs for new source repository 2023-04-11 16:45:36 -04:00

Fedora Mindshare Committee documentation

This repository contains the source content for the Fedora Mindshare Committee documentation. The Antora configuration files and AsciiDoc source content are hosted in this repository. Please report Issues and submit Merge Requests for content fixes here.

Report an issue with the Mindshare Committee docs

Noticed some wrong or incorrect with the Mindshare Committee documentation? Open a new Issue to report the problem. Check the list of open issues first to see if someone else has already reported the problem before opening a new issue.

Fedora Mindshare Committee docs issues

Local preview

This repo includes scripts to build and preview the contents of this repository. Both scripts work on Fedora (using Podman) and macOS (using Docker). To build and preview the site, run the following commands in a terminal:

cd /path/to/fedora/mindshare/docs/
./docsbuilder.sh -b && ./docsbuilder.sh -p

A preview of local changes will be available at localhost:8080.

NOTE: If you xref to pages from other repositories, those links will not work in this local preview as it only builds this repository. If you want to rebuild the whole Fedora Docs site, please see the Fedora Docs build repository for instructions.

Installing Podman on Fedora

You may need to install Podman using the following command on Fedora Linux:

sudo dnf install podman