Note / technical decisions
How to choose between two plausible fixes
When both approaches sound reasonable, more research can make the choice harder. Turn the decision into the next check that can produce evidence.
Write the approaches in plain language
Describe what would change, not which option feels more elegant. “Move setup into the worker test” is easier to compare than “use the cleaner design.”
Ask what evidence would change your mind
Look for a test, trace, review comment, or small experiment. If you cannot name evidence, you may be comparing preferences rather than approaches.
Prefer a reversible check
Run the focused test. Read the failure. Compare the behavior on a small fixture. A check is useful when its result tells you which branch deserves more work.
Record the revisit point
Write down when you will look again and what result matters. This prevents the decision from reopening every time you return to the ticket.
Your text stays in this browser by default. This note is general information, not medical care or crisis support.