New testing strategy: Educational tests using Literate.jl
Core principles:
- Tests are primary teaching material (not just validation)
- Literate.jl generates docs from test files (always synchronized)
- Structured progression: fundamentals → linear → nonlinear → advanced
- Fast tests (< 5 min unit, < 30 min full suite)
- Target: 99% code coverage
Test hierarchy:
- tutorials/ - Literate.jl files (test + documentation)
- unit/ - Fast isolated function tests
- verification/ - Known analytical solutions
8-week implementation roadmap:
Week 1: Infrastructure (Literate.jl setup)
Week 2-3: Core tutorials (10-15 fundamental topics)
Week 4-5: Advanced tutorials (contact, mortar)
Week 6: Unit tests (fill coverage gaps → 99%)
Week 7: Verification tests (validate correctness)
Week 8: Polish and publish documentation
Philosophy: 'Tests are not a chore - they teach users how to use JuliaFEM.'
Ready to start Phase 1 implementation.
Jukka Aho