diff --git a/css-values-5/Overview.bs b/css-values-5/Overview.bs
index b280a82c838..ad2fca2d667 100644
--- a/css-values-5/Overview.bs
+++ b/css-values-5/Overview.bs
@@ -2755,7 +2755,7 @@ Tree Counting Functions: the ''sibling-count()'' and ''sibling-index()'' notatio
 	as an <<integer>>,
 	the index of the element
 	on which the notation is used
-	among the children of its parent.
+	among its [=inclusive siblings=].
 	Like '':nth-child()'',
 	''sibling-index()'' is 1-indexed.
 
@@ -2803,9 +2803,9 @@ Tree Counting Functions: the ''sibling-count()'' and ''sibling-index()'' notatio
 
 	</div>
 
-	Note: Like the rest of CSS (other than [=selectors=]),
-	''sibling-count()'' and ''sibling-index()''
-	operate on the [=flat tree=].
+	Note: These functions, to match [=selectors=] like '':nth-child()'', operate on the DOM tree,
+	rather than the [=flat tree] like most CSS values do.
+	They may, in the future, have variants that support counting [=flat tree=] siblings.
 
 	Note: These functions may, in the future,
 	be extended to accept an ''of <<complex-real-selector-list>>'' argument,