diff --git a/doc/go_faq.html b/doc/go_faq.html index c038bc46bd..f273688705 100644 --- a/doc/go_faq.html +++ b/doc/go_faq.html @@ -479,6 +479,15 @@ as when hosting an untrusted program, the implementation could interlock map access.
+
+Map access is unsafe only when updates are occurring.
+As long as all goroutines are only reading—looking up elements in the map,
+including iterating through it using a
+for range loop—and not changing the map
+by assigning to elements or doing deletions,
+it is safe for them to access the map concurrently without synchronization.
+