diff --git a/doc_src/doc.hdr b/doc_src/doc.hdr
index 55d4c453e..7af9f7256 100644
--- a/doc_src/doc.hdr
+++ b/doc_src/doc.hdr
@@ -609,6 +609,10 @@ square brackets, like this:
 echo $PATH[3]
 </pre>
 
+Note that array indices start at 1 in fish, not 0, as is more common
+in other languages. This is because many common unix tools like seq
+are more suited to such use. 
+
 If you do not use any brackets, all the elements of the array will be
 written as separate items. This means you can easily iterate over an
 array using this syntax: