Skip to content

docs: add common testing gotchas#1923

Merged
bpamiri merged 1 commit intodevelopfrom
peter/testing-docs-gotchas
Mar 8, 2026
Merged

docs: add common testing gotchas#1923
bpamiri merged 1 commit intodevelopfrom
peter/testing-docs-gotchas

Conversation

@bpamiri
Copy link
Collaborator

@bpamiri bpamiri commented Mar 7, 2026

Summary

  • Add "Common Gotchas" section to docs/src/working-with-wheels/testing-your-application.md covering 5 pitfalls discovered during Phase 1 feature testing
  • Update CLAUDE.md testing section with accurate paths and key warnings
  • Create .ai/wheels/testing/unit-testing.md AI reference doc for TestBox test infrastructure

Gotchas Documented

  1. CFML closure scoping — closures can't access outer local vars; use shared structs
  2. Model cache reload&reload=true needed after adding new model CFCs
  3. DROP+CREATE vs IF NOT EXISTS — stale tables miss schema changes in populate.cfm
  4. Test model table naming — always call table() to avoid convention surprises
  5. TestBox JSON parsing — non-standard booleans break strict parsers; use Node.js

Test plan

  • No code changes, documentation only
  • Verified all gotchas against live test environment

🤖 Generated with Claude Code

Document common testing pitfalls discovered during Phase 1 feature
testing: CFML closure scoping, model cache reload, DROP+CREATE vs
IF NOT EXISTS, test model table naming, and TestBox JSON parsing.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@github-actions github-actions bot added the docs label Mar 7, 2026
@bpamiri bpamiri merged commit 87bc34b into develop Mar 8, 2026
45 checks passed
@bpamiri bpamiri deleted the peter/testing-docs-gotchas branch March 8, 2026 00:34
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant