diff --git a/docs/userguide/advanced_data_comparison.md b/docs/userguide/advanced_data_comparison.md
index 6117b8fb5..d25411370 100644
--- a/docs/userguide/advanced_data_comparison.md
+++ b/docs/userguide/advanced_data_comparison.md
@@ -250,8 +250,9 @@ FAILURE
   at "anonymous block", line 15
 ```
 **Note**
-> `join_by` matcher is much faster on performing data comparison, consider using `join_by` over unordered
-> `contain` matcher is not considering order of compared data-sets. Using `unordered` makes no difference (it's default)
+> Consider using `join_by( columns... )` over `unordered()` with the `equal` matcher. The `join_by` method is much faster at performing data comparison.
+>
+> The `contain` matcher is not considering the order of the compared data-sets. Using `unordered` makes no difference (it's default).
 
 
 ## Join By option