Update docs

1 files changed, 2 insertions, 1 deletions

diff --git a/docs/arrays.md b/docs/arrays.md
index 8ec047e7..bb5af7c1 100644
--- a/docs/arrays.md
+++ b/docs/arrays.md
@@ -251,7 +251,8 @@ binary_search(arr: [T], by=T.compare) -> Int
 **Returns:**  
 Assuming the input array is sorted according to the given comparison function,
 return the index where the given item would be inserted to maintain the sorted
-order.
+order. That is, if the item is found, return its index, otherwise return the
+place where it would be found if it were inserted and the array were sorted.
 
 **Example:**  
 ```markdown