Commit Graph

2 Commits

Author SHA1 Message Date
Jukka Aho 7571487e86 docs: Update testing philosophy with current progress
Updates based on actual implementation:
- Gmsh chosen over ABAQUS (accessibility, no license needed)
- Co-located mesh files with recipe scripts (reproducible)
- Realistic mesh sizes (~10 elements, not 1-4)
- 1-element validation tests prioritized (Issue #265)
- Progress tracking: 77/77 tests passing (Tutorial 1-2 complete)
- Mesh generation pattern documented (recipe + .msh + test)

New section: 1-Element Validation Tests
- Motivation from Issue #265 (JuliaFEM validated other FEM software)
- Hand-calculable reference solutions
- High priority for Tutorial 4
2025-11-09 02:36:10 +02:00
Jukka Aho 269b9ef0cc docs: Add comprehensive testing philosophy and roadmap
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.
2025-11-09 01:47:30 +02:00