diegosouzapw 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 |