diff --git a/meta/lib/oe/go.py b/meta/lib/oe/go.py
index cbcf80f0b1..2a2cb7e75a 100644
--- a/meta/lib/oe/go.py
+++ b/meta/lib/oe/go.py
@@ -8,8 +8,11 @@ import re
 
 def map_arch(a):
     """
-    Map our architecture names to Go's GOARCH names.
-    See https://github.com/golang/go/blob/master/src/internal/syslist/syslist.go for the complete list.
+    Take ``a``, the architecture name used in OpenEmbedded (see the
+    :term:`TUNE_ARCH` variable), and return a string for the mapped architecture
+    name from Go's ``GOARCH`` names (see
+    https://github.com/golang/go/blob/master/src/internal/syslist/syslist.go
+    for the complete list).
     """
     if re.match('i.86', a):
         return '386'
