Commit graph

37 commits

Author SHA1 Message Date
a0d10dc833 📝 docs(ROOT): Add charter area leads for F45–F46 term (!17)
All checks were successful
Antora docs CI / Build preview (PR) (push) Has been skipped
Antora docs CI / Build pages (main, mindshare namespace) (push) Successful in 9s
The F45 housekeeping meeting (mindshare/tickets#130) assigned each committee member to a charter area, but this was only recorded in a ticket comment. Adding leads directly to the responsibilities section makes ownership visible to the community and to new contributors looking for the right person to contact.

And yes, I did intentionally use `[U+2013]` symbols in this PR. 😉

Reviewed-on: #17
Reviewed-by: Luis Enrique Bazan De Leon <lbazan@noreply.forge.fedoraproject.org>
Reviewed-by: Samyak Jain <jnsamyak@noreply.forge.fedoraproject.org>
Reviewed-by: Akashdeep Dhar <t0xic0der@noreply.forge.fedoraproject.org>
2026-07-29 03:44:48 +00:00
d32054e0b8 📝 docs(procedures): Document org-level label schema for issue triage (!15)
All checks were successful
Antora docs CI / Build preview (PR) (push) Has been skipped
Antora docs CI / Build pages (main, mindshare namespace) (push) Successful in 9s
The Mindshare Committee introduced charter areas in the previous term. Now, we have Forgejo labels (`charter/events`, `charter/recognition`, `charter/ambassadorship`) to triage work against any of the three charter areas.

The labels have also been retroactively applied across both the `mindshare/docs` and `mindshare/tickets` repositories. Without docs, new members and contributors have no reference for which labels to use or what the exclusive prefix groups mean. This page serves as the canonical reference so label usage stays consistent as the team grows.

![A screenshot of the "Issue & PR Labels on Fedora Forge" documentation page in dark mode, showing navigation sidebars and main content that uses multiple tables to categorize and describe repository labels by Charter area, Needs, Scope, State, and Team.](/attachments/23526e8c-0ee6-4957-b475-76509eb5464a "A screenshot of a Fedora documentation web page titled \"Issue & PR Labels on Fedora Forge,\" displaying various tables that define project labels and their corresponding descriptions.")

Reviewed-on: #15
Reviewed-by: Luis Enrique Bazan De Leon <lbazan@noreply.forge.fedoraproject.org>
Reviewed-by: Samyak Jain <jnsamyak@noreply.forge.fedoraproject.org>
Reviewed-by: Akashdeep Dhar <t0xic0der@noreply.forge.fedoraproject.org>
2026-07-29 03:38:22 +00:00
92eb6e5f39
Revise the meeting documentation
All checks were successful
Antora docs CI / Build pages (main, mindshare namespace) (pull_request) Has been skipped
Antora docs CI / Build preview (PR) (pull_request) Successful in 13s
Antora docs CI / Build preview (PR) (push) Has been skipped
Antora docs CI / Build pages (main, mindshare namespace) (push) Successful in 12s
Signed-off-by: Akashdeep Dhar <akashdeep.dhar@gmail.com>
2026-07-28 08:40:03 +05:30
647076fa3f
🐛 docs: Fix broken Antora xrefs that trigger build errors
All checks were successful
Antora docs CI / Build pages (main, mindshare namespace) (pull_request) Has been skipped
Antora docs CI / Build preview (PR) (pull_request) Successful in 10s
Antora docs CI / Build preview (PR) (push) Has been skipped
Antora docs CI / Build pages (main, mindshare namespace) (push) Successful in 9s
The reimbursements page used fully-qualified component paths
(`mindshare-committee:ROOT:`) for pages that live in the events and
policy modules, not `ROOT`. These xrefs resolve to nothing in any
environment. Similarly, `teams.adoc` referenced a nonexistent
`mindshare.adoc` instead of the actual index page.

Assisted-by: Claude Opus 4.6 (1M context)
Signed-off-by: Justin Wheeler <jwheel@redhat.com>
2026-07-13 15:44:22 -04:00
fe609689e3
📝 docs(ROOT): Update committee roster; add Former Members page
All checks were successful
Antora docs CI / Build pages (main, mindshare namespace) (pull_request) Has been skipped
Antora docs CI / Build preview (PR) (pull_request) Successful in 13s
Antora docs CI / Build preview (PR) (push) Has been skipped
Antora docs CI / Build pages (main, mindshare namespace) (push) Successful in 9s
The Fedora Mindshare Committee election results were announced on
2026-06-13. Emma Kidney (@ekidney) and Sumantro Mukherjee (@sumantrom)
stepped back. Mat H. (@theprogram) and Samyak Jain (@jnsamyak) were
elected. Akashdeep Dhar (@t0xic0der) and Luis Bazan (@lbazan) won
another term. Greg Sutcliffe (@gwmngilfen) stepped back from Community
Ops Representative and Joseph Gayoso (@joseph) from Marketing Team
Representative; both seats are currently vacant.

Current members are now listed at the top of the main page so visitors
see the active roster first. Former members were moved to a dedicated
page (`former-members.adoc`) organized chronologically by Fedora release
cycle. The FCA role is presented as an ordered list reflecting the
succession from Bex to Marie Nordin to me.

Also updates stale references: issue tracker URL from GitLab to Forgejo,
fiscal year to CY26, and major version to F44.

FYI @theprogram @t0xic0der @jnsamyak @lbazan

Assisted-by: Claude Opus 4.6 (1M context)
Signed-off-by: Justin Wheeler <jwheel@redhat.com>

📝 docs(ROOT): Address @jnsamyak review on former members page

Fix missing F40 election cycle: I think @ffmancera served F39 and F40,
not just F39. Also, add a NOTE admonition explaining the F43
restructuring from team-based appointed representatives to elected
Program Administrators with two appointed positions.

Assisted-by: Claude Opus 4.6 (1M context)
Signed-off-by: Justin Wheeler <jwheel@redhat.com>
2026-07-09 22:52:11 -04:00
c414258adc
📝 docs(events): Address @jnsamyak review feedback on Event Box pages
All checks were successful
Antora docs CI / Build pages (main, mindshare namespace) (pull_request) Has been skipped
Antora docs CI / Build preview (PR) (pull_request) Successful in 9s
Antora docs CI / Build preview (PR) (push) Has been skipped
Antora docs CI / Build pages (main, mindshare namespace) (push) Successful in 9s
Rename inventory type categories from Consistent/Other to Equipment/Swag
/Supplies for clarity. Remove duplicate Flock 2026 Postcards entry from
the EMEA sticker section. Replace ambiguous "TBD" tumbler quantity with
a dash and "Needs verification" note. Expand the GLC acronym to "Red
Hat's Global Logistics Center (GLC)" and link the inventory pages
directly from the "After Your Event" section using Antora xrefs.

Assisted-by: Claude Opus 4.6 (1M context)
Signed-off-by: Justin Wheeler <jwheel@redhat.com>
2026-07-09 10:24:09 -04:00
4a785e37f3
✏️ docs(events): Clarify budget thresholds with precise symbols
All checks were successful
Antora docs CI / Build pages (main, mindshare namespace) (pull_request) Has been skipped
Antora docs CI / Build preview (PR) (pull_request) Successful in 8s
@t0xic0der flagged the nav labels as ambiguous: "$150" and "$1000" could
be read as exactly-that-amount or up-to-that-amount. Engineers often
read symbols literally. Switched nav labels to use the "≤" symbol and
updated the policy pages to say "equal to or less than" with explicit
USD denomination so there is no room for interpretation.

Assisted-by: Claude Opus 4.6 (1M context)
Signed-off-by: Justin Wheeler <jwheel@redhat.com>
2026-07-08 23:46:04 -04:00
609b002bd1
📝 docs(events): Update Event Box inventories; address review feedback
Inventory for both boxes was stale. Updated from the shared Pelican
tracker spreadsheet: NA box last verified by @carlwgeorge after LFNW
2026; EMEA box last verified by @lruzicka after DevConf CZ 2026. The
EMEA sticker inventory expanded from 7 items to 22 to reflect the actual
post-DevConf CZ stock, most of which is depleted.

Addresses review feedback from @t0xic0der and @ekidney: renamed
"American" to "Continental United States" for geographic consistency,
added a Type column to the NA table to match the EMEA table structure,
fixed the intro paragraph that incorrectly said "European" on the US
page, and added new sections to the overview for requesting a box, post-
event responsibilities, and a two-year archival policy for maintenance
history.

Assisted-by: Claude Opus 4.6 (1M context)
Signed-off-by: Justin Wheeler <jwheel@redhat.com>
2026-07-08 23:45:32 -04:00
e8d0db8c68
📝 docs(events): Centralize Event Box inventory and logistics
All checks were successful
Antora docs CI / Build pages (main, mindshare namespace) (pull_request) Has been skipped
Antora docs CI / Build preview (PR) (pull_request) Successful in 8s
Migrates the Fedora Event Box (Pelican case) tracking from disparate
Wiki pages and spreadsheets into the central Antora-based documentation.
This establishes a single source of truth for event organizers regarding
shipping logistics and current inventory levels for 2026.

Changes included in this commit:

* Create `modules/events/pages/boxes/index.adoc`:
  - Defines the purpose and goals of the Event Boxes program.
  - Standardized shipping specifications (weight/dimensions) to assist
    organizers with courier bookings.
  - Adds a "Call for Participation" for establishing APAC and LATAM
    boxes.

* Create `modules/events/pages/boxes/united-states.adoc`:
  - Establishes inventory tracking for the North American box based in
    Raleigh, NC.
  - Notes the inclusion of the ThinkPad X1 and Slimbook hardware.

* Create `modules/events/pages/boxes/europe.adoc`:
  - Establishes inventory tracking for the EMEA box based in Brno, CZ.
  - Adds specific warnings regarding international laptop shipping
    limits for legal compliance.

* Update `modules/events/nav.adoc`:
  - Restructures the navigation to include "Event Guidelines &
    Resources".
  - Links the new Event Box pages into the main sidebar.

Signed-off-by: Justin Wheeler <jwheel@redhat.com>
2026-07-08 19:20:52 -04:00
c6135be453
🐛💚 ci: Fix Antora build that has never passed on Forgejo
All checks were successful
Antora docs CI / Build preview (PR) (push) Has been skipped
Antora docs CI / Build pages (main, mindshare namespace) (push) Successful in 8s
Every CI run since migration failed at the `upload-artifact@v4` step,
which rejects non-GitHub forges with `GHESNotSupportedError`. The Antora
build itself always succeeded. Remove `upload-artifact` (it served no
deployment purpose) and the stale `.gitlab-ci.yml` alongside it.

Add `--log-failure-level fatal` to the `build-pages` job so cross-repo
`xref` warnings (`marketing::`, `council::`, etc.) are visible in the
Actions log but don't block the build. The `build-preview` job already
had this flag.

Assisted-by: Claude Opus 4.6 (1M context)
Signed-off-by: Justin W. Flory <jflory7@fedoraproject.org>
Signed-off-by: Justin Wheeler <jwheel@redhat.com>
2026-07-08 19:18:54 -04:00
0841efed8f
📝 docs(README): Fix script start command, update URLs
Some checks failed
Antora docs CI / Build pages (main, fedora namespace) (pull_request) Has been skipped
Antora docs CI / Build preview (PR) (pull_request) Failing after 10s
Antora docs CI / Build preview (PR) (push) Has been skipped
Antora docs CI / Build pages (main, fedora namespace) (push) Failing after 10s
- Updated build and preview instructions
- Updated links

Signed-off-by: Sandro Bonazzola <sbonazzo@redhat.com>
2026-07-08 16:04:35 -04:00
357f19f81b Update teams page
Some checks failed
Antora docs CI / Build pages (main, fedora namespace) (pull_request) Has been skipped
Antora docs CI / Build preview (PR) (pull_request) Failing after 20s
Antora docs CI / Build preview (PR) (push) Has been skipped
Antora docs CI / Build pages (main, fedora namespace) (push) Failing after 10s
- Update Design Team doc page URL
- Update Web Sites Team doc page URL

Signed-off-by: Sandro Bonazzola <sbonazzo@redhat.com>
2026-04-23 10:07:48 +02:00
Greg Sutcliffe
6758125cc5
Add Forgejo-style CI workflow, 3rd try
Some checks failed
Antora docs CI / Build preview (PR) (push) Has been skipped
Antora docs CI / Build pages (main, fedora namespace) (push) Failing after 9s
Signed-off-by: Greg Sutcliffe <github@emeraldreverie.org>
2026-03-04 12:06:18 +00:00
Greg Sutcliffe
22bb66ffd5
Add Forgejo-style CI workflow, v6 checkout
Some checks failed
Antora docs CI / Build preview (PR) (push) Has been skipped
Antora docs CI / Build pages (main, fedora namespace) (push) Failing after 8s
Signed-off-by: Greg Sutcliffe <github@emeraldreverie.org>
2026-03-04 11:50:04 +00:00
Greg Sutcliffe
651eac7916
Add Forgejo-style CI workflow, first pass
Some checks failed
Antora docs CI / Build preview (PR) (push) Has been skipped
Antora docs CI / Build pages (main, fedora namespace) (push) Failing after 21s
Signed-off-by: Greg Sutcliffe <github@emeraldreverie.org>
2026-03-04 11:38:52 +00:00
50953d8b91
🔧 docs: Change Antora Docker Hub image to Fedora Docs Site image
It looks like this was a recent change made to the upstream docs builder
script. I'm adding this change here.

Signed-off-by: Justin Wheeler <jwheel@redhat.com>
2026-01-15 12:25:02 -05:00
471f0e23b9 Refine Digital Ambassadorship definition 2025-12-16 10:25:32 +00:00
e3d4a02673 Update Mindshare Docs with new committee members 2025-09-05 08:37:12 +05:30
317b9aea64
📝 docs(policy): Address reviewer feedback for FRRs process
This commit addresses reviewer feedback for the Fedora Reimbursement
Requests (FRR) process and policy. Some highlights of modified changes:

* Change in format of timestamps, thanks @pbokoc.
* Clarify what is required for a bank proof, thanks @NekoNya3.
* Clarify reporter's role in confirming the receipt of the
  reimbursement, thanks @smeragoel.

Signed-off-by: Justin Wheeler <jwheel@redhat.com>
2025-05-26 17:01:13 -04:00
494a0200a7
🆕📝 policy: Introduce Fedora Reimbursement Requests (FRRs)
This commit creates new policy for the Fedora Mindshare Committee about
how reimbursements should be made to the Fedora community when they
attend or organize events that receive public approval from the
Mindshare Committee.

The processes for reimbursements are not clear today. This served a good
opportunity to create policy so reimbursements become more clear. Over
time, we can create more documentation for Mindshare Committee members
towards how to implement and apply the policy in practice.

Signed-off-by: Justin Wheeler <jwheel@redhat.com>
2025-05-26 16:14:52 -04:00
7e75cb7021
📝 docs(index): Add unfilled seats to current members list
This makes it more clear that there are other seats in the Mindshare
Committee and that the FCA is not an authoritarian dictator.

Signed-off-by: Justin Wheeler <jwheel@redhat.com>
2025-05-26 16:06:25 -04:00
76bd29d165
📝 docs(index): Update composition, current members, past members
This commit reworks the Fedora Mindshare Committee documentation to
reflect the newly-approved structure that the charter already reflects.
This makes the Fedora Community Architect position the only persistent
role in the current formation of the Committee, allowing room for the
two appointed members (Marketing, CommOps) and the four elected roles,
published on Monday, 2 June 2025.
2025-05-26 15:52:13 -04:00
Adrian Edwards
f58fff8e46 📝 docs(limesurvey): Change URL from Pagure to GitLab
Per the referenced discussion below, I updated the link to point to the new GitLab repo, rather than the old Pagure one (preserving the pre-filled template).

ref: https://matrix.to/#/%23commops%3Afedoraproject.org/%24LBemN_9PjuBl89MaiuLCls-jDO578lalbGh2AN5mfLI
2025-04-14 13:32:19 -04:00
6d6b64671b
📝 index: Refactor committee responsibilities and composition
This commit updates the Fedora Mindshare Committee charter to reflect
the proposed revamp.

- Refocuses the Responsibilities section on Regional Event Support,
  Recognition Service, and Digital Ambassadorship.
- Reorganizes and clarifies the descriptions of responsibilities within
  each area.
- Updates the Composition section to reflect the new committee
  structure, including Program Administrators, Marketing Team
  Representative, and CommOps Representative.
- Provides concise summaries of the roles and duties of each committee
  member.

Signed-off-by: Justin W. Wheeler <jwf@redhat.com>
2025-04-04 13:23:04 -04:00
3baef0b18c
📝🔨 docsbuilder.sh: Update latest upstream docs dev build script
This commit pulls the latest version of the script used to run a Fedora
Docs developer environment. Notably, there is only a single script to
run and the container remains running while you make changes. Changes
are rebuilt dynamically without having to re-run the script manually.

This is a bit of devrel improvement before making some bigger changes to
the Mindshare Committee documentation via Merge Request.

Signed-off-by: Justin W. Wheeler <jwf@redhat.com>
2025-04-04 13:16:59 -04:00
Luis Bazan
e63fdbfaa8 Update Fedora Mindshare Elected members 2025-01-06 21:28:03 +00:00
6fd0a4322a 🏗️ Antora: Create policy module 2023-06-11 15:09:38 +00:00
901ce84c4c 🏗️ events: Create new Antora module
This commit changes the information architecture of event-related
documentation in the Mindshare Committee docs site. Content was changed
minimally; most changes were to mention GitLab instead of Pagure or to
use Discourse/Matrix instead of mailing lists/IRC.

Additionally, the pages in this section now use attributes for several
links. In the event that a link changes in the future, it will be easier
to update URLs from a single place instead of several links becoming
outdated.

I chose to separate the events documentation into a new module because
it provides a greater degree of separation from other content published
in the Mindshare Committee documentation. It can exist as a more
independent part of our docs instead of getting grouped together with
Committee procedures, policies, and onboarding guidance for members.

Signed-off-by: Justin W. Flory (he/him) <jwf@redhat.com>

Use Camel Case in the navfile

Petr Bokoč
2023-04-27 20:13:00 +00:00
67c3b929f9 🔧 partials: Tweak team description, update Fedora release version 2023-04-27 18:23:59 +00:00
82d5005373 📝 index.adoc: Introduce partials, refresh for 2023 2023-04-19 17:45:14 +00:00
dac295a32e
🐛 🔧 antora.yml: Change version from master to ~
@py0xc3 pointed out the difference with the Community Architecture
documentation. Perhaps something changed within Antora in newer versions
that is causing this breakage. The local build and preview still work,
so this commit is an experiment to see if the docs site will rebuild
with this configuration change.

Also, comments were split out to multiple lines to make it easier to
read in git diffs.

Signed-off-by: Justin W. Flory (he/him) <jwf@redhat.com>
2023-04-12 17:14:20 -04:00
3e806c47fd
✏️ index.adoc: Name the correct elected representative
This commit backports a commit made to the previous documentation
repository for the Mindshare Committee. The Committee membership is now
up-to-date on the index page.

Signed-off-by: Justin W. Flory (he/him) <jwf@redhat.com>
2023-04-11 23:18:49 -04:00
aa54bf20cd
📝 Add dev docs to README, improve style guide adherence
This commit makes several mostly cosmetic changes to the AsciiDoc source
material for the Mindshare Committee documentation index page:

* Adhere to one-sentence-per-line convention
* Add header anchors to all anchors (easier to change the headers later
  without breaking existing links)
* Update "FCAIC" to "FCA" and link to Council role page where applicable
* Minor styling and cosmetic changes

Additionally, the README was updated to better explain this repository's
purpose and how to build the documentation site in a local environment.

Signed-off-by: Justin W. Flory (he/him) <jwf@redhat.com>
2023-04-11 17:36:53 -04:00
4febec78cb
🚨 antora.yml: Fix @antora/content-classifier warning
Fixes the following warning during the Antora build pipeline:

`Start page specified for master@mindshare-committee not found: ROOT:index`

Signed-off-by: Justin W. Flory (he/him) <jwf@redhat.com>
2023-04-11 17:09:22 -04:00
56078217ba
👷 CI: Add GitLab CI pipeline
This is a GitLab CI configuration file shared by the Fedora Docs team
for building preview sites on a Merge Request against this repo. This
will enable easier reviews for a maintainer when checking out a new
contribution and whether it works as expected.

Signed-off-by: Justin W. Flory (he/him) <jwf@redhat.com>
2023-04-11 17:05:16 -04:00
a752cc6919
🚚 Update paths and configs for new source repository
This commit is a bulk change to all files from the original state in
Pagure. Notably, this commit brings in updated versions of the build/
preview scripts, removes unnecessary files, and removes the starting
path for the documentation. Since this repository will only be used for
Mindshare docs and no other purpose, the docs will build from the root
directory.

No content was changed or edited, only moved.

Signed-off-by: Justin W. Flory (he/him) <jwf@redhat.com>
2023-04-11 16:45:36 -04:00
94811d6bbe
🎉 Initial commit
This commit contains a file-for-file copy from the Mindshare Committee
repository currently hosted on Pagure. Subsequent changes will modify
the Mindshare Committee documentation to only build from this repo, in
line with our ongoing migration from Pagure to GitLab.

https://pagure.io/mindshare/issue/370

Signed-off-by: Justin W. Flory (he/him) <jwf@redhat.com>
2023-04-11 16:23:33 -04:00