diff --git a/examples/joining-iterable-objects/joining_iterable_objects.md b/examples/joining-iterable-objects/joining_iterable_objects.md
index e66928aa2d..46c5e1e07a 100644
--- a/examples/joining-iterable-objects/joining_iterable_objects.md
+++ b/examples/joining-iterable-objects/joining_iterable_objects.md
@@ -1,6 +1,7 @@
 # Join iterable objects
 
-A `join` clause performs an inner or left outer equijoin. The result is similar to using the nested `from` clauses and `where` clause.
+A `join` clause performs an inner or left outer equi-join. The result is similar to using the nested `from` clauses and `where` clause.
+Variables declared in the query expression before the join clause are accessible only on the left side of the join condition, while variables declared in the join clause are accessible only on the right side of the join condition.
 
 ::: code joining_iterable_objects.bal :::