Required Files Based on paper.tex

Exact File References in Paper

Line 988: Repository Instructor Resources

The paper explicitly states:

"The repository includes instructor resources: \texttt{CONTRIBUTING.md} (guidelines for bug reports and curriculum improvements), \texttt{INSTRUCTOR.md} (30-minute setup guide, grading rubrics, common student errors), and \texttt{MAINTENANCE.md} (support commitment through 2027, succession planning for community governance)."

Required Files:

1. ✅ CONTRIBUTING.md - Guidelines for bug reports and curriculum improvements
2. ✅ INSTRUCTOR.md - 30-minute setup guide, grading rubrics, common student errors
3. ❌ MAINTENANCE.md - Removed per user request (paper mentions it but user doesn't want it)

Line 999: TA Guide

The paper explicitly states:

"The repository provides \texttt{TA_GUIDE.md} documenting frequent student errors (gradient shape mismatches, disconnected computational graphs, broadcasting failures) and debugging strategies."

Required File: 4. ✅ TA_GUIDE.md - Frequent student errors and debugging strategies

Line 1003: Sample Solutions

The paper states:

"Sample solutions and grading rubrics in \texttt{INSTRUCTOR.md} calibrate evaluation standards."

Required Content (must be in INSTRUCTOR.md):

• Sample solutions (for grading calibration)
• Grading rubrics

Summary: Required Files

File	Purpose	Status
CONTRIBUTING.md	Bug reports, curriculum improvements	✅ Exists
INSTRUCTOR.md	Setup guide, grading rubrics, common errors, sample solutions	✅ Created
TA_GUIDE.md	Common errors, debugging strategies	✅ Created

Content Verification

CONTRIBUTING.md ✅

• Guidelines for bug reports ✅
• Guidelines for curriculum improvements ✅

INSTRUCTOR.md ✅

• 30-minute setup guide ✅ (Section: "Instructor Setup")
• Grading rubrics ✅ (Section: "Grading Rubric for ML Systems Questions")
• Common student errors ✅ (Section: "Troubleshooting" → "Common Student Issues")
• Sample solutions ⚠️ (Mentioned but need to verify if included)

TA_GUIDE.md ✅

• Gradient shape mismatches ✅
• Disconnected computational graphs ✅
• Broadcasting failures ✅
• Debugging strategies ✅

Files NOT Required by Paper

These files exist but are NOT explicitly mentioned in the paper:

• TEAM_ONBOARDING.md - Not mentioned (but Model 3 is described in text)
• MAINTENANCE.md - Mentioned but removed per user request
• docs/STUDENT_QUICKSTART.md - Not explicitly mentioned
• site/ documentation - Not explicitly mentioned (but needed for website)

Action Items

1. ✅ Remove MAINTENANCE.md (done)
2. ✅ Verify CONTRIBUTING.md matches paper description
3. ⚠️ Verify INSTRUCTOR.md has sample solutions (need to check/add if missing)
4. ✅ Verify TA_GUIDE.md has all required errors

Note on MAINTENANCE.md

The paper mentions MAINTENANCE.md but the user doesn't want it. The maintenance commitment information (support through 2027, etc.) is described in the paper text but doesn't need to be in a separate file if the user prefers not to have it.