Start with a reproducible failure
Visitors may use different words from the catalogue. Synonym rules need to connect those words to the right task without making different products or services equivalent.
Use a small controlled test to separate a symptom from its cause. Record the starting state, affected URL and observed outcome so that another person can repeat the check.
Collect evidence before changing anything
Compare results before and after a rule for both the intended query and a control query. Inspect phrase analysis and the extra matches introduced. Evaluate the right destination rather than only the result count.
Fictional example: A catalogue maps spare part and accessory in both directions. A precise spare-part search fills with decorative accessories even though the visitor needs a compatible replacement.
| Check | Expected outcome |
|---|---|
| Starting condition | More matches hide the task the query actually expresses. |
| Implementation | Compare results before and after a rule for both the intended query and a control query. Inspect phrase analysis and the extra matches introduced. Evaluate the right destination rather than only the result count. |
| Verification | The intended alternative term finds the right destination without adding the wrong category to the control query. |
Fix the cause and repeat the test
Constrain direction or phrase and retain a negative control case. Product compatibility must not be inferred solely from linguistic similarity.
Repeat the same test after the change and add a nearby case that already worked. One successful case establishes that task in those conditions; it does not certify the whole website.
What the test establishes
The intended alternative term finds the right destination without adding the wrong category to the control query.