Implement wiki structure for team training

Entities flattened (compile fix):
- entities/students/ → entities/ (bruno.md, riley.md moved up)
- Added structured frontmatter (skills, status, track)
- Added related hub links

New training hub:
- training/hubs/swere-training-hub.md — learning path from motor to autonomous
- Links: NEO Vortex, SPARK Flex, MK4i, Canjectors, YAGSL, PhotonVision
- Level 1: Motor + controller
- Level 2: Swerve modules
- Level 3: Software + odometry
- Student progress tracking table

This enables the Fabric to surface learning gaps before students hit them.
This commit is contained in:
MrC
2026-05-05 12:02:04 +00:00
parent 634598a665
commit 6a225979ea
5 changed files with 214 additions and 103 deletions

71
entities/bruno.md Normal file
View File

@@ -0,0 +1,71 @@
---
type: student-profile
date: 2026-05-03
updated: 2026-05-05
discord: bruno_2890
track: mechanical
skills:
fusion-360: intermediate
cad-beginner: true
pathplanner: beginner
status:
roller-coaster: in-progress
battery-box: in-progress
fusion-360-exercises: in-progress
---
# Bruno — Student Profile
## Who He Is
- Active student on Team 2890
- Planner — uses kanban for life management (wants to do everything)
- Working on roller coaster sub-task 3 (stuck 4+ days)
- Active in robotics build
- Has decent Fusion 360 skills (had Mr. Silver's engineering class)
- Discord: bruno_2890
## Training Progress
| Track | Level | Status | Last Updated |
|-------|-------|--------|--------------|
| Mechanical | Beginner | In progress | 2026-05-05 |
| Fusion 360 | Intermediate | Practicing | 2026-05-05 |
| PathPlanner | Beginner | Not started | — |
## Current Tasks (from board)
**High Priority:**
- [ ] Build battery box
- [ ] Build vertical battery box
**Roller Coaster Project (5 parts):**
- [ ] Finish cart body [1/5]
- [ ] Finish bogie design [2/5]
- [ ] Finish track designs [3/5]
- [ ] Assemble cart and bogie in CAD [4/5]
- [ ] Print them out [5/5]
**Other:**
- [ ] Organize robotics storage room
## Related Training Hubs
- [[swerve-training-hub]] — drivetrain fundamentals
- [[cad-training-hub]] — Fusion 360 learning path
- [[photonvision]] — vision-based odometry (future)
## Achievements Earned
| Badge | Earned Date | Notes |
|-------|-------------|-------|
| — | — | None yet |
## Completions Log
| Date | Action | Details |
|------|--------|---------|
| 2026-05-05 | Skills updated | Added Fusion 360 intermediate, PathPlanner beginner |
---
*Profile managed by MrC. Updates when Bruno earns badges, completes modules, or asks questions.*

58
entities/riley.md Normal file
View File

@@ -0,0 +1,58 @@
---
type: student-profile
date: 2026-05-03
updated: 2026-05-05
discord: rileythesheep
track: mechanical
skills:
fusion-360: intermediate
driver: former
climber-assembly: rebuilding
status:
climber-rebuild: in-progress
gps-wiring: pending
---
# Riley — Student Profile
## Who He Is
- Student on Team 2890
- Technician, former driver
- Discord: rileythesheep
- Strong CAD operator
- Currently working on: Rebuild climber assembly (high priority)
## Training Progress
| Track | Level | Status | Last Updated |
|-------|-------|--------|--------------|
| Mechanical | Intermediate | Active | 2026-05-05 |
| Fusion 360 | Intermediate | Strong operator | 2026-05-05 |
| Driver | Former | — | — |
## Current Tasks (from board)
**High Priority:**
- [ ] Rebuild climber assembly
- [ ] Audit GPS sensor wiring
## Related Training Hubs
- [[swerve-training-hub]] — drivetrain fundamentals
- [[cad-training-hub]] — Fusion 360 (strong operator, could help Bruno)
## Achievements Earned
| Badge | Earned Date | Notes |
|-------|-------------|-------|
| — | — | None yet |
## Completions Log
| Date | Action | Details |
|------|--------|---------|
| — | — | — |
---
*Profile managed by MrC. Updates when Riley earns badges, completes modules, or asks questions.*

View File

@@ -1,55 +0,0 @@
---
type: student-profile
date: 2026-05-03
---
# Bruno — Student Profile
## Who He Is
- Active student on Team 2890
- Planner — uses kanban for life management (wants to do everything)
- Working on roller coaster sub-task 3 (stuck 4+ days)
- Active in robotics build
- Has decent Fusion 360 skills (had Mr. Silver's engineering class)
## Training Progress
| Track | Level | Status | Last Updated |
|-------|-------|--------|--------------|
| Electrical | Unknown | Not started | — |
| Mechanical | Unknown | Not started | — |
| Pneumatics | Unknown | Not started | — |
## Current Tasks (from board)
- [ ] Build battery box (high priority)
- [ ] Build vertical battery box (medium)
- [ ] Roller coaster: finish cart body [1/5]
- [ ] Roller coaster: finish bogie design [2/5]
- [ ] Roller coaster: finish track designs [3/5]
- [ ] Roller coaster: assemble cart and bogie in CAD [4/5]
- [ ] Roller coaster: print them out [5/5]
- [ ] Organize robotics storage room
## Achievements Earned (Lego Badges)
| Badge | Earned Date | Notes |
|-------|-------------|-------|
| — | — | None yet |
---
## Completions Log
| Date | Action | Details |
|------|--------|---------|
| — | — | — |
---
## How MrC Updates This
MrC updates this profile when:
- Bruno mentions earning a badge → add to Achievements Earned
- Bruno says "I finished X" → add to Completions Log
- Bruno asks a question (routes to level)
- MrC surfaces a gap or recommendation

View File

@@ -1,48 +0,0 @@
---
type: student-profile
date: 2026-05-03
---
# Riley — Student Profile
## Who He Is
- Student on Team 2890
- Technician, former driver
- Discord: rileythesheep
- Currently working on: Rebuild climber assembly (high priority)
## Training Progress
| Track | Level | Status | Last Updated |
|-------|-------|--------|--------------|
| Electrical | Unknown | Not started | — |
| Mechanical | Unknown | Not started | — |
| Pneumatics | Unknown | Not started | — |
## Current Tasks (from board)
- [ ] Rebuild climber assembly (high priority, mechanical)
- [ ] Audit GPS sensor wiring (high priority, electrical)
## Achievements Earned (Lego Badges)
| Badge | Earned Date | Notes |
|-------|-------------|-------|
| — | — | None yet |
---
## Completions Log
| Date | Action | Details |
|------|--------|---------|
| — | — | — |
---
## How MrC Updates This
MrC updates this profile when:
- Riley mentions earning a badge → add to Achievements Earned
- Riley says "I finished X" → add to Completions Log
- Riley asks a question (routes to level)
- MrC surfaces a gap or recommendation

View File

@@ -0,0 +1,85 @@
---
type: training-hub
title: "Swerve Training Hub"
description: "Learning path for Team 2890 swerve drivetrain — from motor to autonomous"
status: active
students:
- bruno
- riley
related:
- sources/2890/swerve-modules.md
- sources/2890/neo-vortex-motor.md
- sources/2890/spark-flex.md
- sources/2890/mothman-robot-code.md
- training/modules/systemcore.md
---
# Swerve Training Hub
## Overview
This hub guides students through the **Team 2890 swerve drivetrain** — from how the motor works to how to program autonomous paths. All content is specific to our hardware: SDS MK4i modules, NEO Vortex motors, SPARK Flex controllers, and YAGSL Java library.
## Hardware Stack
| Component | Spec | Doc |
|-----------|------|-----|
| **Motor** | NEO Vortex (565 Kv, 6784 RPM) | [[neo-vortex-motor]] |
| **Controller** | SPARK Flex (60A continuous) | [[spark-flex]] |
| **Gearbox** | MAXPlanetary (27 ratios, cartridge-based) | [[maxplanetary-gearbox]] |
| **Module** | SDS MK4i (L1/L3 field-swappable) | [[swere-modules]] |
| **CAN Interconnect** | Canjectors (Endz/Minor/Major) | [[canjectors]] |
| **Odometry** | CANcoder + YAGSL | [[mothman-robot-code]] |
## Learning Path
### Level 1 — Motor and Controller
1. [[neo-vortex-motor]] — how the motor works, Kv rating, stall torque
2. [[spark-flex]] — how the controller drives the motor, PWM vs CAN
3. [[maxplanetary-gearbox]] — why we need gears, cartridge ratios
**Check for understanding:** Explain why a 6784 RPM motor needs reduction to drive a wheel.
### Level 2 — Swerve Modules
1. [[swere-modules]] — how the MK4i module translates rotation into motion
2. L1 vs L3 — when to use each (speed vs. torque)
3. [[canjectors]] — how CAN signals route from roboRIO to each module
**Check for understanding:** Sketch a swerve module. Label wheel, gear train, motor, steering motor, CANcoder.
### Level 3 — Software and Odometry
1. [[mothman-robot-code]] — YAGSL swerve implementation
2. [[systemcore]] — roboRIO replacement coming (understand the platform)
3. [[photonvision]] — AprilTag pose estimation for autonomous
**Check for understanding:** What's the difference between wheel odometry and vision pose?
## Student Progress
| Student | Level | Status | Last Active |
|---------|-------|--------|------------|
| [[bruno]] | Level 1-2 | In progress — roller coaster + battery box | 2026-05-05 |
| [[riley]] | Level 2-3 | Strong CAD operator, rebuilding climber | 2026-05-05 |
## Training Resources
- **FIRST Tech Docs** — [YAGSL Documentation](https://github.com/Team2910/YAGSL-Allwpilib)
- **Chief Delphi** — Swerve share thread (tons of student-built robots)
- **SDS MK4i Product Page** — [SDS Documentation](https://www.swervedrivespecialties.com/products/mk4i)
## Prerequisites
- Basic Git usage (for cloning YAGSL)
- Basic Java (for reading/changing robot code)
- Fusion 360 basics (for understanding CAD if doing mechanical track)
## Gaps Detected
> **MrC monitoring:** This hub tracks learning path completion. Gaps surface when:
> - A student is stuck on a concept for >3 days
> - A hub link points to a missing document
> - Student profile shows no progress in 7+ days
---
*Hub managed by MrC. Add students, update progress, link new training modules as they're created.*