Athlete Documentation Skill
Documentation guidance for the athlete persona in WODsmith competition platform.
Athlete Persona
Who they are: CrossFit athletes registering for and participating in competitions, and volunteers helping at events.
Key differences from organizers:
| Aspect | Athletes | Organizers |
|---|---|---|
| Interaction | Consumer (read-heavy) | Producer (write-heavy) |
| Complexity | Simple workflows | Complex multi-step setup |
| Discovery | High (browsing, exploring) | Low (knows what they need) |
Critical Workflow
REQUIRED: Before writing athlete docs:
- •Load the parent skill:
skills_use(name="documentation") - •Apply the Diataxis compass from that skill
- •Load the workflow reference below for athlete-specific guidance
Workflow References (load on demand)
REQUIRED: Before writing docs, load the relevant reference:
| If documenting... | Load this reference |
|---|---|
| Registration, Division selection, Confirmation | references/registration-journey.md |
| Schedule, Heats, Workouts, Check-in | references/competition-day.md |
| Leaderboard, Scores, Final standings | references/results-tracking.md |
| Volunteer signup, Credentials, Assignments | references/volunteer-journey.md |
Documentation Mapping
Tutorials (3 workflows)
- •Register for Your First Competition
- •Volunteer at an Event
- •Track Your Results During Competition
How-to Guides (6 workflows)
- •Update Your Registration
- •View Your Heat Schedule
- •Check Your Division Standings
- •View Workout Standards
- •Complete Event Check-in
- •Change Division Selection
Reference (4 topics)
- •Scoring Rules
- •Division Requirements
- •Heat Format Specifications
- •Registration Status Definitions
Explanation (4 topics)
- •How Heats Work
- •Scoring Methodology
- •The Division System
- •Competition Day Flow
User Journeys
Journey 1: Discovery to Registration Find Competition → Explore Details → Register → Confirm
Journey 2: Pre-Competition Prep Check Schedule → View Workouts → Plan Strategy
Journey 3: Competition Day Check-in → View Heat Schedule → Track Scores
Journey 4: Post-Competition View Results → Compare Rankings → Share
Journey 5: Volunteer Experience Sign Up → Get Assignment → Event Day
Route Reference
| Route | Auth | Primary Doc Type |
|---|---|---|
/c/[slug] | No | N/A (entry point) |
/c/[slug]/register | Yes | Tutorial / How-to |
/c/[slug]/volunteer | No | Tutorial / How-to |
/c/[slug]/workouts | No | Reference |
/c/[slug]/schedule | No | How-to |
/c/[slug]/leaderboard | No | How-to / Tutorial |
/my-schedule | Yes | How-to |