Skip to content

Add shared FAQ page with collapsible questions#69

Open
devin-ai-integration[bot] wants to merge 25 commits intomainfrom
devin/1774206582-shared-faq-page
Open

Add shared FAQ page with collapsible questions#69
devin-ai-integration[bot] wants to merge 25 commits intomainfrom
devin/1774206582-shared-faq-page

Conversation

@devin-ai-integration
Copy link
Copy Markdown
Contributor

@devin-ai-integration devin-ai-integration bot commented Mar 22, 2026

Summary

Consolidates FAQs from individual event pages into a single shared FAQ page at /faqs/ (also aliased at /faq/). Questions are organized into sections and use collapsible <details>/<summary> elements so users can scan titles and expand what's relevant.

FAQ sections (sentence case): Registration & fees, At the competition, BMT (targeted to high schoolers), BmMT (targeted to middle schoolers), Online competitions, Scores & awards.

New FAQs added (based on analysis of ~370 threads from the team@ Google Group over the past year): registration flow, parent-as-coach, fee waivers, refunds, chaperone requirements, parking/transit, practice materials, Focus vs General test, online/in-person switching, contest round overviews, team score calculation, what to bring, award structure.

Event pages updated: bmt-2025, bmmt-2026, bmt-2025-online, bmmt-2026-online — inline FAQs replaced with a link to the shared page.

Custom CSS for <details>/<summary> elements: rounded card borders, chevron indicator that rotates on expand, hover/open state styling, proper spacing.

Changes since initial revision

  • Section restructure: Removed standalone "Eligibility" section — eligibility FAQs now live under "BMT (targeted to high schoolers)" and "BmMT (targeted to middle schoolers)" respectively. Merged "Preparing for the Tournament" into "At the competition". Combined online FAQs into a single shared question.
  • Section renaming: "Tournament Day" → "At the competition", "After the Tournament" → "Scores & awards", "Registration" → "Registration & fees". All headings use sentence case (h3).
  • More event-specific FAQs: Added contest round overview and team score calculation FAQs for both BMT and BmMT, with details on round types, durations, and scoring weights.
  • Content updates: Refund policy reworded to "we provide refunds under some circumstances" (ContestDojo is seat-based). Online switch FAQ covers accidental registration. Parent-as-coach FAQ clarifies "organization" label and recommends team participation. Reduced em dash usage. Removed unnecessary bolding. Lowercased terms like coach, organization, organization join code.
  • Parking FAQ: Updated with info from recent logistics posts — recommends BART, expanded parking garage list (7 garages), links to UC Berkeley Parking website.
  • CSS fixes: Fixed list indentation inside <details> — padding on details element with negative margin on summary, letting prose plugin handle content naturally. Balanced bottom padding.

Updates from Discord feedback

  • Registration steps: Step 4 reordered to "purchases seats and assigns students" (seats first). Step 2 now includes "registers the organization for an event" before receiving the join code.
  • Teammate Finder: Changed "connect with other students" → "connect with other coaches". Clarified location: "listed under the 'How to Register' section for each event." Added note that you can register before finding teammates. Applied same fix in "What if no full team" FAQ.
  • Seat swapping: Reworded to "the seats you purchased on ContestDojo belong to your organization" with check-in lock note.
  • Chaperone: Removed "designated substitute" language → "any responsible adult may serve as the chaperone."
  • Fee waiver: Added step-by-step guidance on when to request (after creating account, org, and registering for event).
  • Section headers: Changed from "BMT (high school)" to "BMT (targeted to high schoolers)" / "BmMT (targeted to middle schoolers)".
  • What to bring: New FAQ added under "At the competition" (pencils, erasers, protractors/rulers/compasses, water bottle; no calculators or graph paper).
  • Awards: Added award tier structure verified from BMT 2025 and BmMT 2025 results archives — Honorable Mention (top 50%), Distinguished Honorable Mention (top 20%), and top 10 recognized per individual test; top 10 for team rounds and overall. Removed incorrect participation certificates claim. Award tier names capitalized as proper nouns.

Review & Testing Checklist for Human

  • Award structure accuracy: FAQ states per-individual-test tiers (HM top 50%, DHM top 20%, top 10) and team-round/overall top 10 only. This was derived from BMT 2025 and BmMT 2025 results slides — verify this matches the intended award structure going forward and that team rounds truly don't have HM/DHM tiers.
  • Scoring weights: BMT: 30% Power / 40% Individual / 30% Guts. BmMT: 20% Puzzle / 40% Individual / 30% Team / 10% Relay. These are hardcoded and could become stale across years.
  • "General Test counts for half as many individual points as Focus Tests": This claim in the BMT scoring FAQ was never verified against the actual scoring model.
  • Content accuracy: FAQ answers (refund policy, fee waiver process, chaperone requirements) were largely inferred from Google Group responses, not official policy docs. Review each for correctness.
  • Parking anchor link UX: bmmt-2026.md links to /faqs/#where-can-i-find-parking-how-can-i-get-to-berkeley. This scrolls to the right <details> element but won't auto-expand it.

Suggested test plan: Deploy the preview, navigate to /faqs/, and verify: (1) all collapsibles open/close with correct chevron behavior, (2) numbered list in "How do I register" is properly indented, (3) award tiers match expectations, (4) parking FAQ anchor link from bmmt-2026 Travel section works. Preview: https://pr-69.berkeley-mt.pages.dev/faqs/

Notes

  • Older/past event pages (bmt-2024, bmmt-2025, etc.) still have inline FAQs — left as-is since they're historical.
  • The FAQ page is not added to the site navigation; it's only reachable via links from event pages (and directly at /faqs/). You may want to add it to the nav.

Link to Devin session: https://app.devin.ai/sessions/2be00878c49c4146997dfc31d912fffe
Requested by: @oliver-ni


Open with Devin

- Create content/faqs.md with sectioned, collapsible FAQ using details/summary
- Sections: Registration, Eligibility, Tournament Day, Preparing, BMT-Specific, BmMT-Specific, After the Tournament
- Add new FAQs based on Google Group analysis: registration flow, parent-as-coach, fee waivers, refunds, chaperones, scores/certificates, practice materials, Focus vs General test
- Replace inline FAQs on event pages (bmt-2025, bmmt-2026, bmt-2025-online, bmmt-2026-online) with link to shared FAQ page
- Add CSS styling for collapsible details/summary elements
- Fix internal FAQ anchor link in bmmt-2026 Travel section

Co-Authored-By: Oliver Ni <oliver.ni@gmail.com>
@devin-ai-integration
Copy link
Copy Markdown
Contributor Author

🤖 Devin AI Engineer

I'll be helping with this pull request! Here's what you should know:

✅ I will automatically:

  • Address comments on this PR. Add '(aside)' to your comment to have me ignore it.
  • Look at CI failures and help fix them

Note: I can only respond to comments from users who have write access to this repository.

⚙️ Control Options:

  • Disable automatic comment and CI monitoring

Co-Authored-By: Oliver Ni <oliver.ni@gmail.com>
Co-Authored-By: Oliver Ni <oliver.ni@gmail.com>
Copy link
Copy Markdown
Contributor Author

@devin-ai-integration devin-ai-integration bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

✅ Devin Review: No Issues Found

Devin Review analyzed this PR and found no potential bugs to report.

View in Devin Review to see 2 additional findings.

Open in Devin Review

…ames

Co-Authored-By: Oliver Ni <oliver.ni@gmail.com>
… defaults

Co-Authored-By: Oliver Ni <oliver.ni@gmail.com>
…rally

Co-Authored-By: Oliver Ni <oliver.ni@gmail.com>
Co-Authored-By: Oliver Ni <oliver.ni@gmail.com>
Co-Authored-By: Oliver Ni <oliver.ni@gmail.com>
Co-Authored-By: Oliver Ni <oliver.ni@gmail.com>
…e online FAQ, clarify organization

Co-Authored-By: Oliver Ni <oliver.ni@gmail.com>
devin-ai-integration bot and others added 3 commits March 22, 2026 22:03
…gistics posts

Co-Authored-By: Oliver Ni <oliver.ni@gmail.com>
Co-Authored-By: Oliver Ni <oliver.ni@gmail.com>
devin-ai-integration bot and others added 2 commits March 22, 2026 22:06
Co-Authored-By: Oliver Ni <oliver.ni@gmail.com>
Co-Authored-By: Oliver Ni <oliver.ni@gmail.com>
devin-ai-integration bot and others added 2 commits March 22, 2026 22:10
… FAQ

Co-Authored-By: Oliver Ni <oliver.ni@gmail.com>
Co-Authored-By: Oliver Ni <oliver.ni@gmail.com>
…der, fee waivers, chaperone, section headers, what to bring, online certificates

Co-Authored-By: Oliver Ni <oliver.ni@gmail.com>
devin-ai-integration bot and others added 2 commits March 28, 2026 17:06
Co-Authored-By: Oliver Ni <oliver.ni@gmail.com>
Co-Authored-By: Oliver Ni <oliver.ni@gmail.com>
Co-Authored-By: Oliver Ni <oliver.ni@gmail.com>
…roper nouns

Co-Authored-By: Oliver Ni <oliver.ni@gmail.com>
Co-Authored-By: Oliver Ni <oliver.ni@gmail.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant