Add `width="100%"` to every HTML content and contributor table across all
project READMEs so they render full-width on GitHub instead of collapsing
to natural content width. Cell-level `width="X%"` percentages were already
in place but only take effect once the table itself has an explicit width.
Also update the contributor-sync scripts so the auto-generated tables stay
consistent on the next bot run:
- .github/workflows/contributors/generate_main_readme.py
- .github/workflows/contributors/generate_readme_tables.py
Scope: 27 files, 85 tables. Sub-project READMEs that already use the
"card" pattern (labs/, kits/ content sections with <table width="98%">
wrappers) are intentionally untouched.
- Fix pool_size=(2,2) → kernel_size=2, stride=2 in 02_lecun_cifar10.py
- Normalize all Conv2D/MaxPool2D/BatchNorm2D references to lowercase d
(Conv2d, MaxPool2d, BatchNorm2d) across comments, strings, and ASCII art
- Fix Conv2d error string in 09_convolutions.py source module
- Delete milestones/extras/ directory (drifted copies, 2 placeholders,
1 broken script — maintenance liability that caused the duplicate bug)
- Add test_milestones_smoke.py: 19 lightweight tests that import every
milestone script and construct every model class in 0.07s, catching
API drift without data downloads
Standardize table formatting across 25 README files to use
HTML tables with consistent styling (thead/tbody, column widths,
bold labels) matching the main README's presentation.
Add comprehensive tests that run each milestone script fully:
- Tests all 6 milestones (01-06) with actual training
- Verifies correct outputs and accuracy thresholds
- Marked as @pytest.mark.slow for release validation
- Suitable for e2e testing, not regular CI
These tests validate the complete educational experience works end-to-end.
Remove test_milestones_run.py and test_learning_verification.py as they
duplicate functionality already covered by module and integration tests.
The milestone demo scripts remain for student use, but running them as
tests adds no value beyond the existing test coverage.
- Skip test_performance.py by default (timing-sensitive benchmarks)
- Skip test_attention_runs (non-deterministic transformer training)
Both can be run manually when needed. This ensures CI passes reliably.
Test results: 845 passed, 36 skipped in ~4 minutes
- Fix BenchmarkSuite instantiation (requires models, datasets params)
- Delete test_checkpoint_integration.py (tests non-existent APIs)
- Limit environment tests to main requirements.txt only
- Fix variable name bug in integration_simple_test.py
- Fix PositionalEncoding, TransformerBlock, LayerNorm API calls
- Fix milestone CLI tests to use 'tito milestone' not 'milestones'
- Add TITO_ALLOW_SYSTEM env var for CLI tests
- Move imports to module level in all *_core.py test files (16 files)
- Remove try/except/skip patterns from integration tests
- Remove @pytest.mark.skip decorators from gradient flow tests
- Convert environment validation skips to warnings for optional checks
- Change milestone tests from skip to fail when scripts missing
Tests now either pass or fail - no silent skipping that hides issues.
This ensures the test suite provides accurate feedback about what works.
- Update remaining 1957→1958 references across all documentation
- Add tito dev commands (preflight, export, validate) to CLI reference
- Update CLI validation script to recognize new dev subcommands
- Fix milestone year references in tests and workflow code
- Update timeline visualization JavaScript
This completes the Perceptron year standardization to align with
the publication year and academic citation format (rosenblatt1958perceptron).
Cherry-picked from: ebf3fb17b (feature/tito-dev-validate)
- Rename milestone directory from 01_1957_perceptron to 01_1958_perceptron
- Update all references to use 1958 (publication year) for consistency
with academic citation format (rosenblatt1958perceptron)
- Changes affect: READMEs, docs, tests, milestone tracker
Rationale: Using 1958 aligns with the publication year and standard
academic citations, while 1957 was the development year.
Cherry-picked from: 28ca41582 (feature/tito-dev-validate)
Vijay Janapa Reddi