📝 docs(events): 2026 refresh of event request guidelines #6
No reviewers
Labels
No labels
charter
ambassadorship
charter
events
charter
recognition
good first issue
help wanted
needs
event report
needs
reporter feedback
needs
vote
scope
bug
scope
improvement
scope
new
state
approved
state
blocked
state
duplicate
state
invalid
state
wontfix
team
advocates
team
ambassadors
team
commops
team
council
team
design
team
docs
team
g11n
team
marketing
team
mindshare
team
websites-apps
No milestone
No project
No assignees
5 participants
Notifications
Due date
Dependencies
No dependencies set.
Reference
mindshare/docs!6
Loading…
Add table
Add a link
Reference in a new issue
No description provided.
Delete branch "fix/mindshare-event-request-templates"
Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?
Refresh the Fedora Mindshare Committee event request guidelines for 2026 and the migration to Forgejo.
Content changes
?issuable_template=) to Forgejo (?template=.forgejo/issue_template/) format.event-requestsrepo links: swag requests now point to the Mindshare Committee Tickets tracker, reimbursements nowxrefthe Fedora Reimbursement Requests (FRR) policy page.state/approvedlabel instead of a freeform "approved message."Antora partial restructuring
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)
This Merge Request definitely needs a fresh look, now that !4, !8, and !9 are all merged. Instead of scraping it altogether, I think a lot of these changes can be salvaged and adapted to fit with Fedora Reimbursement Requests, as introduced in !4
50bde0288ctoa99cf1092aa99cf1092a0d72f65abf0d72f65abf5ae6c524b95ae6c524b9cee0a7328e📝 events: 2023-2024 refresh of event request guidelinesto 📝 events: 2026 refresh of event request guidelinescee0a7328e640f8e80c0640f8e80c044be9eda82This PR has been in the works for a long time, originally opened against GitLab and now migrated to Forgejo. I have updated it to reflect where we are today. The key substantive changes to review:
state/approvedlabel rather than leaving a freeform "approved message."These are the changes that affect how event owners and the Committee interact with the process, so please focus your review there. The rest is structural cleanup (how the AsciiDoc pages are composed).
@lbazan @t0xic0der @jnsamyak @theprogram -- I would appreciate your review. I will leave this open for everyone to get a chance to look at it.
Assisted-by: Claude Opus 4.6 (1M context)
44be9eda82c3645d8fad📝 events: 2026 refresh of event request guidelinesto 📝 docs(events): 2026 refresh of event request guidelinesLooks good for me! +1
c3645d8fadf75c081169Okay, I went through the whole diff the migration from GitLab to Forgejo looks correct. All three issue templates (small-events.yml, medium-large-events.yml, swag-only.yml) exist in the tickets repo, and the reimbursements xref resolves fine. I have one change, there is a place we are still using a hardcoded attribute, otherwise good to go.
Approving this, since it doesn't have any blocking changes.
@ -61,3 +61,3 @@These reports should help us understand what happened and how the party went.Ideas for what went well and what could be improved are welcome.. If you have financial assistance approved, file a reimbursement ticket in the link:https://gitlab.com/fedora/mindshare/event-requests[Event Requests repository].. If you have financial assistance approved, submit a reimbursement request by following the xref:mindshare-committee:policy:reimbursements.adoc[Fedora Reimbursement Requests (FRR) process].Follow the Getting Financial Assistance and Swag section xref:ROOT:advocate.adoc#_getting_swag_or_financial_support[here].Line 73 below, I think, might be worth revisiting in a separate issue, but do we want to pull that section out at some other place? Should we revisit and see what is relevent in
647076fa3f/modules/ROOT/pages/advocate.adocanyway?@jnsamyak Good eye. I am omitting this for now. Will push a new commit shortly.
Fixed in commit
4b5b24ad9b.@ -5,3 +7,4 @@:revdate: 2026-07-10While anyone can hold or attend a large Fedora-related event, these events are typically done by experienced Fedora contributors and or existing Fedora Ambassadors.A large event is one where the budget is over $1000 or the event is generally larger or more complicated.Large event intro still hardcodes the dollar amount^
description uses {event_budget_large}, and medium/small both use the attribute in their body text. This one was missed I think.
Fixed in commit
4b5b24ad9b.@ -4,3 +6,4 @@:page-aliases: ROOT:medium-events.adoc:revdate: 2026-07-10While anyone can hold or attend a medium Fedora-related event, these events are typically done by experienced Fedora contributors and or existing Fedora Ambassadors.I think just "or" suffices here. (or we can and/or)
Fixed in commit
4b5b24ad9b.Good draft.
Some more changes needed.
@ -27,1 +27,4 @@// Approved budget amounts:event_budget_small: maximum $150 USD:event_budget_medium: maximum $1000 USDUse
$1,000 USDinstead of$1000 USD. Helps readability.Fixed in commit
4b5b24ad9b.@ -28,0 +28,4 @@// Approved budget amounts:event_budget_small: maximum $150 USD:event_budget_medium: maximum $1000 USD:event_budget_large: over $1000 USDUse
$1,000 USDinstead of$1000 USD. Helps readability.Fixed in commit
4b5b24ad9b.@ -0,0 +1,5 @@include::ROOT:partial$attributes.adoc[]Open a {team_name} ticket in the link:{team_issue_tracker}[team issue tracker].Click link:{team_issue_tracker}/issues/new?template=.forgejo%2fissue_template%2fswag-only.yml[*here*] to open the ticket template.This link is the same as that in the
request-swag.adocfile. Changes needed or not?This is correct. Both partials direct the user to open a ticket on Fedora Forge using the correct swag request template.
@ -0,0 +1,5 @@include::ROOT:partial$attributes.adoc[]If this event needs Fedora swag, open a swag request in the link:{team_issue_tracker}[Mindshare tickets tracker] using the link:{team_issue_tracker}/issues/new?template=.forgejo%2fissue_template%2fswag-only.yml[swag-only template].This link is the same as that in the
open-ticket-swag-only.adocfile. Is it really intended?See previous comment. It is intended because the partials are used on different pages.
@ -16,4 +12,0 @@* Help the {team_name} understand how you are qualified to help make this a success.You may want to talk about your experience, or contribution history.* Think about how you will use the budget and what kind of swag support, if any, will help you be successful.We like to see the budget spent directly on the event or attendance and not on swag production.This still looks like a useful guidance, no? Sometimes it does need explicitly stating.
This kind of information belongs in documentation, not an issue template. Putting it in the issue template makes one more place to keep information up to date. We can link out to the event pages in each template as a future iteration.
@ -5,3 +7,4 @@:revdate: 2026-07-10While anyone can hold or attend a large Fedora-related event, these events are typically done by experienced Fedora contributors and or existing Fedora Ambassadors.A large event is one where the budget is over $1000 or the event is generally larger or more complicated.Use
$1,000 USDinstead of$1000 USD. Helps readability.Also use that fancy
{{event_budget_large}}here, no?Fixed in commit
4b5b24ad9b.@ -13,2 +14,3 @@== Step 1: Open a request ticket. Monitor your ticket for questions from the Committee.include::ROOT:partial$event-request-instruction-blocks/open-ticket-swag-only.adoc[]The issue tracker resource link is the same as that in Step #4.
Now presenting "Unending Limbo: Fedora Mindshare Swag Edition" 😂
I see what you mean about repetitive instructions. Some of the partial is also used in other pages when swag needs to be requested. This needs a more thoughtful change in the partials. For now, some duplication on the
swag-only.adocpage will be fine, since it is not incorrect information.@ -44,2 +29,3 @@== Step 4: Request swagComment on your issue in the link:{team_issue_tracker}[Mindshare repo] with a link to your event report.include::ROOT:partial$event-request-instruction-blocks/request-swag.adoc[]The issue tracker resource link is the same as that in Step #1.
Just remove this step.
See my previous comment.
f75c081169259a214a8aAll feedback addressed in commit
4b5b24ad9b. I am going to squash down my commits and merge now that all reviewer feedback is addressed. Thanks for taking a close look, folks.4b5b24ad9b387f2c9293