Commit graph

22 commits

Author SHA1 Message Date
387f2c9293
📝 docs(events): 2026 refresh of event request guidelines
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
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
9b33f3f850 📝 docs(ROOT): Define formal selection process for representatives
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 14s
Antora docs CI / Build preview (PR) (push) Has been skipped
Antora docs CI / Build pages (main, mindshare namespace) (push) Successful in 7s
Signed-off-by: Akashdeep Dhar <akashdeep.dhar@gmail.com>
2026-08-14 21:51:00 +00:00
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
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
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
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
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
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
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