knaxuslearn · build · ship

Roadmaps / TypeScript / How the plan works

Read first

How the plan works

Time model. One study week is 8 hours: about 2 hours of reading, 5 of building and 1 of review. The core path is 16 weeks, 128 hours. Optional stretch work adds about 30 hours (six items of about 5 hours), so the full path is 158 hours. Fresher pacing: plan 20 weeks (160 hours), with one extra week in each phase to debug type errors and rerun the checkpoint. At 5 hours a week, allow 26 weeks for the core path; at 4 hours, 32. Week 0 is an extra 8 hours and is optional. Practice projects are the building time of their weeks, not extra hours.

Every phase has the same parts. A weekly table, up to three practice projects, up to five repositories to read, one milestone checkpoint and five questions to check yourself. The checkpoint is the point of the phase. The weekly deliverables are steps toward it.

Scoring. Score each checkpoint yourself, then ask one other engineer to score it. Use six dimensions: specification and budgets; trade-offs and decisions; correctness under failure (including bad data at runtime); measurement; communication and influence; and maintainability (can the next person change it safely). Use four levels: 1 Works on your machine; 2 Sound (specified, tested, repeatable); 3 Proven (trade-offs measured, a seeded fault is caught); 4 Leading (a method other teams reuse, with a measured outcome). With no second engineer, post your hand-in for review in a community forum and cap your self-score at 2.

CheckpointJudged mainly on
1 Domain typesCorrectness under failure; maintainability
2 Contract and boundaryCorrectness under failure; trade-offs
3 Build and speedMeasurement; specification and budgets
4 Governance and releaseMaintainability; communication

Three rules of the bench. Read the compiler's error to the end before you change anything. A type that compiles is a claim, so write the test that shows when the claim is false. Write your prediction before each measurement; the deliverables of Weeks 4, 8, 12 and 16 compare predicted and measured numbers.