aboutsummaryrefslogtreecommitdiff
path: root/scripts
diff options
context:
space:
mode:
authorCraig Jennings <c@cjennings.net>2025-10-29 02:55:35 -0500
committerCraig Jennings <c@cjennings.net>2025-10-29 02:55:35 -0500
commit43218a05a397f404327c4b2db9be432de7991b8d (patch)
treedf10259ea2a1978448f5389793baebf5c872f7c1 /scripts
parent29663886d78e3bb51578483129f58824aaabdb65 (diff)
downloaddotemacs-43218a05a397f404327c4b2db9be432de7991b8d.tar.gz
dotemacs-43218a05a397f404327c4b2db9be432de7991b8d.zip
docs: add test future-proofing and large-scale refactoring lessons
Document key lessons from chime.el timestamp refactoring project: ## New Sections Added **Test Future-Proofing & Time-Based Testing** - Dynamic timestamp generation patterns and benefits - Never hardcode dates in tests - use relative time helpers - Mock time via function substitution (with-test-time pattern) - Code examples showing before/after patterns **Large-Scale Test Refactoring Strategy** - Strategic planning: tackle biggest challenges first - Execution approach: maintain 100% pass rate throughout - Project management: track progress visibly, celebrate milestones - Know when you're done: not all files need changes **Real-World Example** - chime.el project: 23 files, 339 tests - 16 files refactored (251 tests), 7 files skipped (88 tests) - 100% pass rate maintained across all refactoring - Result: future-proof test suite that never expires ## Key Insights - "Tackle biggest challenge first" eliminates intimidation - Work in batches but commit individually for clean history - Don't let perfectionism create unnecessary work - Strategic approach builds momentum and confidence Added "Hardcoded dates in tests" to Red Flags section. These lessons capture the methodology that successfully completed the hardest refactoring task in the project.
Diffstat (limited to 'scripts')
0 files changed, 0 insertions, 0 deletions