diff --git a/doc/go_spec.html b/doc/go_spec.html
index c188cd4c1f..e55f34aa63 100644
--- a/doc/go_spec.html
+++ b/doc/go_spec.html
@@ -1,6 +1,6 @@
@@ -5083,12 +5083,16 @@ These terms and the result of the comparisons are defined as follows:
Struct values are comparable if all their fields are comparable.
Two struct values are equal if their corresponding
- non-blank fields are equal.
+ non-blank field values are equal.
+ The fields are compared in source order, and comparison stops as
+ soon as two field values differ (or all fields have been compared).
Array values are comparable if values of the array element type are comparable.
- Two array values are equal if their corresponding elements are equal.
+ Two array values are equal if their corresponding element values are equal.
+ The elements are compared in ascending index order, and comparison stops
+ as soon as two element values differ (or all elements have been compared).