Testing Guidelines

Follow TDD (Test-Driven Development) for all features and bug fixes. Always write failing tests first.

How to Think About Tests

Before writing any test, answer these questions:

1. What behavior am I verifying?

State it in one sentence. If you can't, the test is too complex.

• ✅ "Verify locale persists when navigating between pages"
• ✅ "Verify users can create a course with a title"
• ❌ "Verify the course description popover opens in the correct language when clicking from a Portuguese page"
• ❌ "Verify the sidebar collapses, remembers state, and shows tooltips on hover when collapsed"

2. What's the simplest proof?