content: clarify return values and naked returns
Fixes golang/go#12768
Change-Id: I18740d3fa002dcd8cef3261177a064f824a5a60a
Reviewed-on: https://go-review.googlesource.com/15080
Reviewed-by: Burcu Dogan <jbd@google.com>
Reviewed-by: Rob Pike <r@golang.org>
diff --git a/content/basics.article b/content/basics.article
index b74c63c..aebcfeb 100644
--- a/content/basics.article
+++ b/content/basics.article
@@ -82,11 +82,11 @@
* Named return values
-Go's return values may be named and act just like variables.
+Go's return values may be named. If so, they are treated as variables defined at the top of the function.
These names should be used to document the meaning of the return values.
-A `return` statement without arguments returns the current values of the results. This is known as a "naked" return.
+A `return` statement without arguments returns the named return values. This is known as a "naked" return.
Naked return statements should be used only in short functions, as with the example shown here. They can harm readability in longer functions.
