content/static/doc: fix typo in "Hellos" function name usage
Fixes golang/go#41252.
Change-Id: Ic4d9ffa2f63443e708a20dc30f8e015e070764d8
Reviewed-on: https://go-review.googlesource.com/c/website/+/253338
Reviewed-by: Emmanuel Odeke <emm.odeke@gmail.com>
Run-TryBot: Emmanuel Odeke <emm.odeke@gmail.com>
TryBot-Result: Gobot Gobot <gobot@golang.org>
diff --git a/content/static/doc/tutorial/greetings-multiple-people.html b/content/static/doc/tutorial/greetings-multiple-people.html
index b0ddcf8..400cc98 100644
--- a/content/static/doc/tutorial/greetings-multiple-people.html
+++ b/content/static/doc/tutorial/greetings-multiple-people.html
@@ -186,7 +186,7 @@
</li>
<li>
Pass the <code>names</code> variable as the argument to the
- <code>Hello</code> function.
+ <code>Hellos</code> function.
</li>
</ul>
</li>
diff --git a/content/static/static.go b/content/static/static.go
index 0030d7d..cb21200 100644
--- a/content/static/static.go
+++ b/content/static/static.go
@@ -95,7 +95,7 @@
"doc/tutorial/getting-started.html": "<!--{\x0a\x20\x20\x20\x20\"Title\":\x20\"Tutorial:\x20Get\x20started\x20with\x20Go\",\x0a\x20\x20\x20\x20\"Path\":\x20\x20\"/doc/tutorial/getting-started\"\x0a}-->\x0a\x0a<p>\x0a\x20\x20In\x20this\x20tutorial,\x20you'll\x20get\x20a\x20brief\x20introduction\x20to\x20Go\x20programming.\x20Along\x20the\x0a\x20\x20way,\x20you\x20will:\x0a</p>\x0a\x0a<ul>\x0a\x20\x20<li>Install\x20Go\x20(if\x20you\x20haven't\x20already).</li>\x0a\x20\x20<li>Write\x20some\x20simple\x20\"Hello,\x20world\"\x20code.</li>\x0a\x20\x20<li>Use\x20the\x20<code>go</code>\x20command\x20to\x20run\x20your\x20code.</li>\x0a\x20\x20<li>\x0a\x20\x20\x20\x20Use\x20the\x20Go\x20package\x20discovery\x20tool\x20to\x20find\x20packages\x20you\x20can\x20use\x20in\x20your\x20own\x0a\x20\x20\x20\x20code.\x0a\x20\x20</li>\x0a\x20\x20<li>Call\x20functions\x20of\x20an\x20external\x20module.</li>\x0a</ul>\x0a\x0a<aside\x20class=\"Note\">\x0a\x20\x20<strong>Note:</strong>\x20For\x20other\x20tutorials,\x20see\x0a\x20\x20<a\x20href=\"index.html\">Tutorials</a>.\x0a</aside>\x0a\x0a<h2\x20id=\"prerequisites\">Prerequisites</h2>\x0a\x0a<ul>\x0a\x20\x20<li>\x0a\x20\x20\x20\x20<strong>Some\x20programming\x20experience.</strong>\x20The\x20code\x20here\x20is\x20pretty\x0a\x20\x20\x20\x20simple,\x20but\x20it\x20helps\x20to\x20know\x20something\x20about\x20functions.\x0a\x20\x20</li>\x0a\x20\x20<li>\x0a\x20\x20\x20\x20<strong>A\x20tool\x20to\x20edit\x20your\x20code.</strong>\x20Any\x20text\x20editor\x20you\x20have\x20will\x0a\x20\x20\x20\x20work\x20fine.\x20Most\x20text\x20editors\x20have\x20good\x20support\x20for\x20Go.\x20The\x20most\x20popular\x20are\x0a\x20\x20\x20\x20VSCode\x20(free),\x20GoLand\x20(paid),\x20and\x20Vim\x20(free).\x0a\x20\x20</li>\x0a\x20\x20<li>\x0a\x20\x20\x20\x20<strong>A\x20command\x20terminal.</strong>\x20Go\x20works\x20well\x20using\x20any\x20terminal\x20on\x0a\x20\x20\x20\x20Linux\x20and\x20Mac,\x20and\x20on\x20PowerShell\x20or\x20cmd\x20in\x20Windows.\x0a\x20\x20</li>\x0a</ul>\x0a\x0a<h2\x20id=\"install\">Install\x20Go</h2>\x0a\x0a<p>Just\x20use\x20the\x20<a\x20href=\"/doc/install\">Download\x20and\x20install</a>\x20steps.</p>\x0a\x0a<h2\x20id=\"code\">Write\x20some\x20code</h2>\x0a\x0a<p>\x0a\x20\x20Get\x20started\x20with\x20Hello,\x20World.\x0a</p>\x0a\x0a<ol>\x0a\x20\x20<li>\x0a\x20\x20\x20\x20Open\x20a\x20command\x20prompt\x20and\x20cd\x20to\x20your\x20home\x20directory.\x0a\x0a\x20\x20\x20\x20<p>\x0a\x20\x20\x20\x20\x20\x20On\x20Linux\x20or\x20Mac:\x0a\x20\x20\x20\x20</p>\x0a\x0a\x20\x20\x20\x20<pre>\x0acd\x0a</pre\x0a\x20\x20\x20\x20>\x0a\x0a\x20\x20\x20\x20<p>\x0a\x20\x20\x20\x20\x20\x20On\x20Windows:\x0a\x20\x20\x20\x20</p>\x0a\x0a\x20\x20\x20\x20<pre>\x0acd\x20%HOMEPATH%\x0a</pre\x0a\x20\x20\x20\x20>\x0a\x20\x20</li>\x0a\x0a\x20\x20<li>\x0a\x20\x20\x20\x20Create\x20a\x20hello\x20directory\x20for\x20your\x20first\x20Go\x20source\x20code.\x0a\x0a\x20\x20\x20\x20<p>\x0a\x20\x20\x20\x20\x20\x20For\x20example,\x20use\x20the\x20following\x20commands:\x0a\x20\x20\x20\x20</p>\x0a\x0a\x20\x20\x20\x20<pre>\x0amkdir\x20hello\x0acd\x20hello\x0a</pre\x0a\x20\x20\x20\x20>\x0a\x20\x20</li>\x0a\x0a\x20\x20<li>\x0a\x20\x20\x20\x20In\x20your\x20text\x20editor,\x20create\x20a\x20file\x20hello.go\x20in\x20which\x20to\x20write\x20your\x20code.\x0a\x20\x20</li>\x0a\x0a\x20\x20<li>\x0a\x20\x20\x20\x20Paste\x20the\x20following\x20code\x20into\x20your\x20hello.go\x20file\x20and\x20save\x20the\x20file.\x0a\x0a\x20\x20\x20\x20<pre>\x0apackage\x20main\x0a\x0aimport\x20\"fmt\"\x0a\x0afunc\x20main()\x20{\x0a\x20\x20\x20\x20fmt.Println(\"Hello,\x20World!\")\x0a}\x0a</pre\x0a\x20\x20\x20\x20>\x0a\x0a\x20\x20\x20\x20<p>\x0a\x20\x20\x20\x20\x20\x20This\x20is\x20your\x20Go\x20code.\x20In\x20this\x20code,\x20you:\x0a\x20\x20\x20\x20</p>\x0a\x0a\x20\x20\x20\x20<ul>\x0a\x20\x20\x20\x20\x20\x20<li>\x0a\x20\x20\x20\x20\x20\x20\x20\x20Declare\x20a\x20<code>main</code>\x20package\x20(a\x20package\x20is\x20a\x20way\x20to\x20group\x0a\x20\x20\x20\x20\x20\x20\x20\x20functions).\x0a\x20\x20\x20\x20\x20\x20</li>\x0a\x20\x20\x20\x20\x20\x20<li>\x0a\x20\x20\x20\x20\x20\x20\x20\x20Import\x20the\x20popular\x0a\x20\x20\x20\x20\x20\x20\x20\x20<a\x20href=\"https://golang.org/pkg/fmt/\"><code>fmt</code>\x20package</a>,\x0a\x20\x20\x20\x20\x20\x20\x20\x20which\x20contains\x20functions\x20for\x20formatting\x20text,\x20including\x20printing\x20to\x20the\x0a\x20\x20\x20\x20\x20\x20\x20\x20console.\x20This\x20package\x20is\x20one\x20of\x20the\x0a\x20\x20\x20\x20\x20\x20\x20\x20<a\x20href=\"https://golang.org/pkg/\">standard\x20library</a>\x20packages\x20you\x20got\x0a\x20\x20\x20\x20\x20\x20\x20\x20when\x20you\x20installed\x20Go.\x0a\x20\x20\x20\x20\x20\x20</li>\x0a\x20\x20\x20\x20\x20\x20<li>\x0a\x20\x20\x20\x20\x20\x20\x20\x20Implement\x20a\x20<code>main</code>\x20function\x20to\x20print\x20a\x20message\x20to\x20the\x0a\x20\x20\x20\x20\x20\x20\x20\x20console.\x20A\x20<code>main</code>\x20function\x20executes\x20by\x20default\x20when\x20you\x20run\x0a\x20\x20\x20\x20\x20\x20\x20\x20code\x20in\x20the\x20file.\x0a\x20\x20\x20\x20\x20\x20</li>\x0a\x20\x20\x20\x20</ul>\x0a\x20\x20</li>\x0a\x0a\x20\x20<li>\x0a\x20\x20\x20\x20Run\x20your\x20code\x20to\x20see\x20the\x20greeting.\x0a\x0a\x20\x20\x20\x20<pre>\x0a$\x20go\x20run\x20hello.go\x0aHello,\x20World!\x0a</pre\x0a\x20\x20\x20\x20>\x0a\x0a\x20\x20\x20\x20<p>\x0a\x20\x20\x20\x20\x20\x20The\x0a\x20\x20\x20\x20\x20\x20<a\x20href=\"https://golang.org/cmd/go/#hdr-Compile_and_run_Go_program\"\x0a\x20\x20\x20\x20\x20\x20\x20\x20><code>go\x20run</code>\x20command</a\x0a\x20\x20\x20\x20\x20\x20>\x0a\x20\x20\x20\x20\x20\x20is\x20one\x20of\x20many\x20<code>go</code>\x20commands\x20you'll\x20use\x20to\x20get\x20things\x20done\x20with\x0a\x20\x20\x20\x20\x20\x20Go.\x20Use\x20the\x20following\x20command\x20to\x20get\x20a\x20list\x20of\x20the\x20others:\x0a\x20\x20\x20\x20</p>\x0a\x0a\x20\x20\x20\x20<pre>\x0a$\x20go\x20help\x0a</pre\x0a\x20\x20\x20\x20>\x0a\x20\x20</li>\x0a</ol>\x0a\x0a<h2\x20id=\"call\">Call\x20code\x20in\x20an\x20external\x20package</h2>\x0a\x0a<p>\x0a\x20\x20When\x20you\x20need\x20your\x20code\x20to\x20do\x20something\x20that\x20might\x20have\x20been\x20implemented\x20by\x0a\x20\x20someone\x20else,\x20you\x20can\x20look\x20for\x20a\x20package\x20that\x20has\x20functions\x20you\x20can\x20use\x20in\x0a\x20\x20your\x20code.\x0a</p>\x0a\x0a<ol>\x0a\x20\x20<li>\x0a\x20\x20\x20\x20Make\x20your\x20printed\x20message\x20a\x20little\x20more\x20interesting\x20with\x20a\x20function\x20from\x20an\x0a\x20\x20\x20\x20external\x20module.\x0a\x0a\x20\x20\x20\x20<ol>\x0a\x20\x20\x20\x20\x20\x20<li>\x0a\x20\x20\x20\x20\x20\x20\x20\x20Visit\x20pkg.go.dev\x20and\x0a\x20\x20\x20\x20\x20\x20\x20\x20<a\x20href=\"https://pkg.go.dev/search?q=quote\"\x0a\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20>search\x20for\x20a\x20\"quote\"\x20package</a\x0a\x20\x20\x20\x20\x20\x20\x20\x20>.\x0a\x20\x20\x20\x20\x20\x20</li>\x0a\x20\x20\x20\x20\x20\x20<li>\x0a\x20\x20\x20\x20\x20\x20\x20\x20Locate\x20and\x20click\x20the\x20<code>rsc.io/quote</code>\x20package\x20in\x20search\x20results\x0a\x20\x20\x20\x20\x20\x20\x20\x20(if\x20you\x20see\x20<code>rsc.io/quote/v3</code>,\x20ignore\x20it\x20for\x20now).\x0a\x20\x20\x20\x20\x20\x20</li>\x0a\x20\x20\x20\x20\x20\x20<li>\x0a\x20\x20\x20\x20\x20\x20\x20\x20On\x20the\x20<strong>Doc</strong>\x20tab,\x20under\x20<strong>Index</strong>,\x20note\x20the\x0a\x20\x20\x20\x20\x20\x20\x20\x20list\x20of\x20functions\x20you\x20can\x20call\x20from\x20your\x20code.\x20You'll\x20use\x20the\x0a\x20\x20\x20\x20\x20\x20\x20\x20<code>Go</code>\x20function.\x0a\x20\x20\x20\x20\x20\x20</li>\x0a\x20\x20\x20\x20\x20\x20<li>\x0a\x20\x20\x20\x20\x20\x20\x20\x20At\x20the\x20top\x20of\x20this\x20page,\x20note\x20that\x20package\x20<code>quote</code>\x20is\x0a\x20\x20\x20\x20\x20\x20\x20\x20included\x20in\x20the\x20<code>rsc.io/quote</code>\x20module.\x0a\x20\x20\x20\x20\x20\x20</li>\x0a\x20\x20\x20\x20</ol>\x0a\x0a\x20\x20\x20\x20<p>\x0a\x20\x20\x20\x20\x20\x20You\x20can\x20use\x20the\x20pkg.go.dev\x20site\x20to\x20find\x20published\x20modules\x20whose\x20packages\x0a\x20\x20\x20\x20\x20\x20have\x20functions\x20you\x20can\x20use\x20in\x20your\x20own\x20code.\x20Packages\x20are\x20published\x20in\x0a\x20\x20\x20\x20\x20\x20modules\x20--\x20like\x20<code>rsc.io/quote</code>\x20--\x20where\x20others\x20can\x20use\x20them.\x0a\x20\x20\x20\x20\x20\x20Modules\x20are\x20improved\x20with\x20new\x20versions\x20over\x20time,\x20and\x20you\x20can\x20upgrade\x20your\x0a\x20\x20\x20\x20\x20\x20code\x20to\x20use\x20the\x20improved\x20versions.\x0a\x20\x20\x20\x20</p>\x0a\x20\x20</li>\x0a\x0a\x20\x20<li>\x0a\x20\x20\x20\x20In\x20your\x20Go\x20code,\x20import\x20the\x20<code>rsc.io/quote</code>\x20package\x20and\x20add\x20a\x20call\x0a\x20\x20\x20\x20to\x20its\x20<code>Go</code>\x20function.\x0a\x0a\x20\x20\x20\x20<p>\x0a\x20\x20\x20\x20\x20\x20After\x20adding\x20the\x20highlighted\x20lines,\x20your\x20code\x20should\x20include\x20the\x0a\x20\x20\x20\x20\x20\x20following:\x0a\x20\x20\x20\x20</p>\x0a\x0a\x20\x20\x20\x20<pre>\x0apackage\x20main\x0a\x0aimport\x20\"fmt\"\x0a\x0a<ins>import\x20\"rsc.io/quote\"</ins>\x0a\x0afunc\x20main()\x20{\x0a\x20\x20\x20\x20<ins>fmt.Println(quote.Go())</ins>\x0a}\x0a</pre>\x0a\x20\x20</li>\x0a\x0a\x20\x20<li>\x0a\x20\x20\x20\x20Put\x20your\x20own\x20code\x20in\x20a\x20module\x20for\x20tracking\x20dependencies.\x0a\x0a\x20\x20\x20\x20<p>\x0a\x20\x20\x20\x20\x20\x20When\x20your\x20code\x20imports\x20packages\x20from\x20another\x20module,\x20a\x20go.mod\x20file\x20lists\x0a\x20\x20\x20\x20\x20\x20the\x20specific\x20modules\x20and\x20versions\x20providing\x20those\x20packages.\x20That\x20file\x0a\x20\x20\x20\x20\x20\x20stays\x20with\x20your\x20code,\x20including\x20in\x20your\x20source\x20code\x20repository.\x0a\x20\x20\x20\x20</p>\x0a\x0a\x20\x20\x20\x20<p>\x0a\x20\x20\x20\x20\x20\x20To\x20create\x20a\x20go.mod\x20file,\x20run\x20the\x0a\x20\x20\x20\x20\x20\x20<a\x0a\x20\x20\x20\x20\x20\x20\x20\x20href=\"https://golang.org/cmd/go/#hdr-Initialize_new_module_in_current_directory\"\x0a\x20\x20\x20\x20\x20\x20\x20\x20><code>go\x20mod\x20init</code>\x20command</a\x0a\x20\x20\x20\x20\x20\x20>,\x20giving\x20it\x20the\x20name\x20of\x20the\x20module\x20your\x20code\x20will\x20be\x20in\x20(here,\x20just\x20use\x0a\x20\x20\x20\x20\x20\x20\"hello\"):\x0a\x20\x20\x20\x20</p>\x0a\x0a\x20\x20\x20\x20<pre>\x0a$\x20go\x20mod\x20init\x20hello\x0ago:\x20creating\x20new\x20go.mod:\x20module\x20hello\x0a</pre\x0a\x20\x20\x20\x20>\x0a\x20\x20</li>\x0a\x0a\x20\x20<li>\x0a\x20\x20\x20\x20Run\x20your\x20code\x20to\x20see\x20the\x20message\x20generated\x20by\x20the\x20function\x20you're\x20calling.\x0a\x0a\x20\x20\x20\x20<pre>\x0a$\x20go\x20run\x20hello.go\x0ago:\x20finding\x20module\x20for\x20package\x20rsc.io/quote\x0ago:\x20found\x20rsc.io/quote\x20in\x20rsc.io/quote\x20v1.5.2\x0aDon't\x20communicate\x20by\x20sharing\x20memory,\x20share\x20memory\x20by\x20communicating.\x0a</pre\x0a\x20\x20\x20\x20>\x0a\x0a\x20\x20\x20\x20<p>\x0a\x20\x20\x20\x20\x20\x20Notice\x20that\x20your\x20code\x20calls\x20the\x20<code>Go</code>\x20function,\x20printing\x20a\x0a\x20\x20\x20\x20\x20\x20clever\x20message\x20about\x20communication.\x0a\x20\x20\x20\x20</p>\x0a\x0a\x20\x20\x20\x20<p>\x0a\x20\x20\x20\x20\x20\x20But\x20before\x20it\x20ran\x20the\x20code,\x20<code>go\x20run</code>\x20located\x20and\x20downloaded\x20the\x0a\x20\x20\x20\x20\x20\x20<code>rsc.io/quote</code>\x20module\x20that\x20contains\x20the\x20package\x20you\x20imported.\x0a\x20\x20\x20\x20\x20\x20By\x20default,\x20it\x20downloaded\x20the\x20latest\x20version\x20--\x20v1.5.2.\x20Go\x20build\x20commands\x0a\x20\x20\x20\x20\x20\x20are\x20designed\x20to\x20locate\x20the\x20modules\x20required\x20for\x20packages\x20you\x20import.\x0a\x20\x20\x20\x20</p>\x0a\x20\x20</li>\x0a</ol>\x0a\x0a<h2\x20id=\"write-more\">Write\x20more\x20code</h2>\x0a\x0a<p>\x0a\x20\x20With\x20this\x20quick\x20introduction,\x20you\x20got\x20Go\x20installed\x20and\x20learned\x20some\x20of\x20the\x0a\x20\x20basics.\x20To\x20write\x20some\x20more\x20code\x20with\x20another\x20tutorial,\x20take\x20a\x20look\x20at\x0a\x20\x20<a\x20href=\"create-module.html\">Create\x20a\x20Go\x20module</a>.\x0a</p>\x0a",
- "doc/tutorial/greetings-multiple-people.html": "<!--{\x0a\x20\x20\x20\x20\"Title\":\x20\"Return\x20greetings\x20for\x20multiple\x20people\",\x0a\x20\x20\x20\x20\"Path\":\x20\x20\"/doc/tutorial/greetings-multiple-people\"\x0a}-->\x0a\x0a<p>\x0a\x20\x20In\x20the\x20last\x20changes\x20you'll\x20make\x20to\x20your\x20module's\x20code,\x20you'll\x20add\x20support\x20for\x0a\x20\x20getting\x20greetings\x20for\x20multiple\x20people\x20in\x20one\x20request.\x20In\x20other\x20words,\x20you'll\x0a\x20\x20handle\x20a\x20multiple-value\x20input\x20and\x20pair\x20values\x20with\x20a\x20multiple-value\x20output.\x0a</p>\x0a\x0a<aside\x20class=\"Note\">\x0a\x20\x20<strong>Note:</strong>\x20This\x20topic\x20is\x20part\x20of\x20a\x20multi-part\x20tutorial\x20that\x20begins\x0a\x20\x20with\x20<a\x20href=\"create-module.html\">Create\x20a\x20Go\x20module</a>.\x0a</aside>\x0a\x0a<p>\x0a\x20\x20To\x20do\x20this,\x20you'll\x20need\x20to\x20pass\x20a\x20set\x20of\x20names\x20to\x20a\x20function\x20that\x20can\x20return\x20a\x0a\x20\x20greeting\x20for\x20each\x20of\x20them.\x20Changing\x20the\x20<code>Hello</code>\x20function's\x0a\x20\x20parameter\x20from\x20a\x20single\x20name\x20to\x20a\x20set\x20of\x20names\x20would\x20change\x20the\x20function\x0a\x20\x20signature.\x20If\x20you\x20had\x20already\x20published\x20the\x20<code>greetings</code>\x20module\x20and\x0a\x20\x20users\x20had\x20already\x20written\x20code\x20calling\x20<code>Hello</code>,\x20that\x20change\x20would\x0a\x20\x20break\x20their\x20programs.\x20In\x20this\x20situation,\x20a\x20better\x20choice\x20is\x20to\x20give\x20new\x0a\x20\x20functionality\x20a\x20new\x20name.\x0a</p>\x0a\x0a<p>\x0a\x20\x20In\x20the\x20last\x20code\x20you'll\x20add\x20with\x20this\x20tutorial,\x20update\x20the\x20code\x20as\x20if\x20you've\x0a\x20\x20already\x20published\x20a\x20version\x20of\x20the\x20<code>greetings</code>\x20module.\x20Instead\x20of\x0a\x20\x20changing\x20the\x20<code>Hello</code>\x20function,\x20add\x20a\x20new\x20function\x0a\x20\x20<code>Hellos</code>\x20that\x20takes\x20a\x20set\x20of\x20names.\x20Then,\x20for\x20the\x20sake\x20of\x0a\x20\x20simplicity,\x20have\x20the\x20new\x20function\x20call\x20the\x20existing\x20one.\x20Keeping\x20both\x0a\x20\x20functions\x20in\x20the\x20package\x20leaves\x20the\x20original\x20for\x20existing\x20callers\x20(or\x20future\x0a\x20\x20callers\x20who\x20only\x20need\x20one\x20greeting)\x20and\x20adds\x20a\x20new\x20one\x20for\x20callers\x20that\x20want\x0a\x20\x20the\x20expanded\x20functionality.\x0a</p>\x0a\x0a<ol>\x0a\x20\x20<li>\x0a\x20\x20\x20\x20In\x20greetings/greetings.go,\x20change\x20your\x20code\x20so\x20it\x20looks\x20like\x20the\x20following.\x0a\x0a\x20\x20\x20\x20<pre>\x0apackage\x20greetings\x0a\x0aimport\x20(\x0a\x20\x20\x20\x20\"errors\"\x0a\x20\x20\x20\x20\"fmt\"\x0a\x20\x20\x20\x20\"math/rand\"\x0a\x20\x20\x20\x20\"time\"\x0a)\x0a\x0a//\x20Hello\x20returns\x20a\x20greeting\x20for\x20the\x20named\x20person.\x0afunc\x20Hello(name\x20string)\x20(string,\x20error)\x20{\x0a\x20\x20\x20\x20//\x20If\x20no\x20name\x20was\x20given,\x20return\x20an\x20error\x20with\x20a\x20message.\x0a\x20\x20\x20\x20if\x20name\x20==\x20\"\"\x20{\x0a\x20\x20\x20\x20\x20\x20\x20\x20return\x20name,\x20errors.New(\"empty\x20name\")\x0a\x20\x20\x20\x20}\x0a\x20\x20\x20\x20//\x20Create\x20a\x20message\x20using\x20a\x20random\x20format.\x0a\x20\x20\x20\x20message\x20:=\x20fmt.Sprintf(randomFormat(),\x20name)\x0a\x20\x20\x20\x20return\x20message,\x20nil\x0a}\x0a\x0a<ins>//\x20Hellos\x20returns\x20a\x20map\x20that\x20associates\x20each\x20of\x20the\x20named\x20people\x0a//\x20with\x20a\x20greeting\x20message.\x0afunc\x20Hellos(names\x20[]string)\x20(map[string]string,\x20error)\x20{\x0a\x20\x20\x20\x20//\x20A\x20map\x20to\x20associate\x20names\x20with\x20messages.\x0a\x20\x20\x20\x20messages\x20:=\x20make(map[string]string)\x0a\x20\x20\x20\x20//\x20Loop\x20through\x20the\x20received\x20slice\x20of\x20names,\x20calling\x0a\x20\x20\x20\x20//\x20the\x20Hello\x20function\x20to\x20get\x20a\x20message\x20for\x20each\x20name.\x0a\x20\x20\x20\x20for\x20_,\x20name\x20:=\x20range\x20names\x20{\x0a\x20\x20\x20\x20\x20\x20\x20\x20message,\x20err\x20:=\x20Hello(name)\x0a\x20\x20\x20\x20\x20\x20\x20\x20if\x20err\x20!=\x20nil\x20{\x0a\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20return\x20nil,\x20err\x0a\x20\x20\x20\x20\x20\x20\x20\x20}\x0a\x20\x20\x20\x20\x20\x20\x20\x20//\x20In\x20the\x20map,\x20associate\x20the\x20retrieved\x20message\x20with\x20\x0a\x20\x20\x20\x20\x20\x20\x20\x20//\x20the\x20name.\x0a\x20\x20\x20\x20\x20\x20\x20\x20messages[name]\x20=\x20message\x0a\x20\x20\x20\x20}\x0a\x20\x20\x20\x20return\x20messages,\x20nil\x0a}</ins>\x0a\x0a//\x20Init\x20sets\x20initial\x20values\x20for\x20variables\x20used\x20in\x20the\x20function.\x0afunc\x20init()\x20{\x0a\x20\x20\x20\x20rand.Seed(time.Now().UnixNano())\x0a}\x0a\x0a//\x20randomFormat\x20returns\x20one\x20of\x20a\x20set\x20of\x20greeting\x20messages.\x20The\x20returned\x0a//\x20message\x20is\x20selected\x20at\x20random.\x0afunc\x20randomFormat()\x20string\x20{\x0a\x20\x20\x20\x20//\x20A\x20slice\x20of\x20message\x20formats.\x0a\x20\x20\x20\x20formats\x20:=\x20[]string{\x0a\x20\x20\x20\x20\x20\x20\x20\x20\"Hi,\x20%v.\x20Welcome!\",\x0a\x20\x20\x20\x20\x20\x20\x20\x20\"Great\x20to\x20see\x20you,\x20%v!\",\x0a\x20\x20\x20\x20\x20\x20\x20\x20\"Hail,\x20%v!\x20Well\x20met!\",\x0a\x20\x20\x20\x20}\x0a\x0a\x20\x20\x20\x20//\x20Return\x20one\x20of\x20the\x20message\x20formats\x20selected\x20at\x20random.\x0a\x20\x20\x20\x20return\x20formats[rand.Intn(len(formats))]\x0a}\x0a</pre>\x0a\x0a\x20\x20\x20\x20<p>\x0a\x20\x20\x20\x20\x20\x20In\x20this\x20code,\x20you:\x0a\x20\x20\x20\x20</p>\x0a\x0a\x20\x20\x20\x20<ul>\x0a\x20\x20\x20\x20\x20\x20<li>\x0a\x20\x20\x20\x20\x20\x20\x20\x20Add\x20a\x20<code>Hellos</code>\x20function\x20whose\x20parameter\x20is\x20a\x20slice\x20of\x20names\x0a\x20\x20\x20\x20\x20\x20\x20\x20rather\x20than\x20a\x20single\x20name.\x20Also,\x20you\x20change\x20one\x20of\x20its\x20return\x20types\x20from\x0a\x20\x20\x20\x20\x20\x20\x20\x20a\x20<code>string</code>\x20to\x20a\x20<code>map</code>\x20so\x20you\x20can\x20return\x20names\x0a\x20\x20\x20\x20\x20\x20\x20\x20mapped\x20to\x20greeting\x20messages.\x0a\x20\x20\x20\x20\x20\x20</li>\x0a\x20\x20\x20\x20\x20\x20<li>\x0a\x20\x20\x20\x20\x20\x20\x20\x20Have\x20the\x20new\x20Hellos\x20function\x20call\x20the\x20existing\x20Hello\x20function.\x20This\x0a\x20\x20\x20\x20\x20\x20\x20\x20leaves\x20both\x20functions\x20in\x20place.\x0a\x20\x20\x20\x20\x20\x20</li>\x0a\x20\x20\x20\x20\x20\x20<li>\x0a\x20\x20\x20\x20\x20\x20\x20\x20Create\x20a\x20<code>messages</code>\x0a\x20\x20\x20\x20\x20\x20\x20\x20<a\x20href=\"https://blog.golang.org/maps\">map</a>\x20to\x20associate\x20each\x20of\x20the\x0a\x20\x20\x20\x20\x20\x20\x20\x20received\x20names\x20(as\x20a\x20key)\x20with\x20a\x20generated\x20message\x20(as\x20a\x20value).\x20In\x20Go,\x0a\x20\x20\x20\x20\x20\x20\x20\x20you\x20initialize\x20a\x20map\x20with\x20the\x20following\x20syntax:\x0a\x20\x20\x20\x20\x20\x20\x20\x20<code>make(map[<em>key-type</em>]<em>value-type</em>)</code>.\x20You\x20have\x0a\x20\x20\x20\x20\x20\x20\x20\x20the\x20<code>Hello</code>\x20function\x20return\x20this\x20map\x20to\x20the\x20caller.\x0a\x20\x20\x20\x20\x20\x20</li>\x0a\x20\x20\x20\x20\x20\x20<li>\x0a\x20\x20\x20\x20\x20\x20\x20\x20Loop\x20through\x20the\x20names\x20your\x20function\x20received,\x20checking\x20that\x20each\x20has\x20a\x0a\x20\x20\x20\x20\x20\x20\x20\x20non-empty\x20value,\x20then\x20associate\x20a\x20message\x20with\x20each.\x20In\x20this\x0a\x20\x20\x20\x20\x20\x20\x20\x20<code>for</code>\x20loop,\x20<code>range</code>\x20returns\x20two\x20values:\x20the\x20index\x0a\x20\x20\x20\x20\x20\x20\x20\x20of\x20the\x20current\x20item\x20in\x20the\x20loop\x20and\x20a\x20copy\x20of\x20the\x20item's\x20value.\x20You\x0a\x20\x20\x20\x20\x20\x20\x20\x20don't\x20need\x20the\x20index,\x20so\x20you\x20use\x20the\x20Go\x0a\x20\x20\x20\x20\x20\x20\x20\x20<a\x20href=\"https://golang.org/doc/effective_go.html#blank\"\x0a\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20>blank\x20identifier\x20(an\x20underscore)</a\x0a\x20\x20\x20\x20\x20\x20\x20\x20>\x0a\x20\x20\x20\x20\x20\x20\x20\x20to\x20ignore\x20it.\x0a\x20\x20\x20\x20\x20\x20</li>\x0a\x20\x20\x20\x20</ul>\x0a\x20\x20</li>\x0a\x0a\x20\x20<li>\x0a\x20\x20\x20\x20In\x20your\x20hello/hello.go\x20calling\x20code,\x20pass\x20a\x20slice\x20of\x20names,\x20then\x20print\x20the\x0a\x20\x20\x20\x20contents\x20of\x20the\x20names/messages\x20map\x20you\x20get\x20back.\x0a\x0a\x20\x20\x20\x20<p>\x0a\x20\x20\x20\x20\x20\x20In\x20hello.go,\x20change\x20your\x20code\x20so\x20it\x20looks\x20like\x20the\x20following.\x0a\x20\x20\x20\x20</p>\x0a\x0a\x20\x20\x20\x20<pre>\x0apackage\x20main\x0a\x0aimport\x20(\x0a\x20\x20\x20\x20\"fmt\"\x0a\x20\x20\x20\x20\"log\"\x0a\x0a\x20\x20\x20\x20\"example.com/greetings\"\x0a)\x0a\x0afunc\x20main()\x20{\x0a\x20\x20\x20\x20//\x20Set\x20properties\x20of\x20the\x20predefined\x20Logger,\x20including\x0a\x20\x20\x20\x20//\x20the\x20log\x20entry\x20prefix\x20and\x20a\x20flag\x20to\x20disable\x20printing\x0a\x20\x20\x20\x20//\x20the\x20time,\x20source\x20file,\x20and\x20line\x20number.\x0a\x20\x20\x20\x20log.SetPrefix(\"greetings:\x20\")\x0a\x20\x20\x20\x20log.SetFlags(0)\x0a\x0a\x20\x20\x20\x20<ins>//\x20A\x20slice\x20of\x20names.\x0a\x20\x20\x20\x20names\x20:=\x20[]string{\"Gladys\",\x20\"Samantha\",\x20\"Darrin\"}</ins>\x0a\x0a\x20\x20\x20\x20//\x20Request\x20greeting\x20messages\x20for\x20the\x20names.\x0a\x20\x20\x20\x20messages,\x20err\x20:=\x20greetings.Hellos(names)\x0a\x20\x20\x20\x20if\x20err\x20!=\x20nil\x20{\x0a\x20\x20\x20\x20\x20\x20\x20\x20log.Fatal(err)\x0a\x20\x20\x20\x20}\x0a\x20\x20\x20\x20//\x20If\x20no\x20error\x20was\x20returned,\x20print\x20the\x20returned\x20map\x20of\x0a\x20\x20\x20\x20//\x20messages\x20to\x20the\x20console.\x0a\x20\x20\x20\x20fmt.Println(messages)\x0a}\x0a</pre>\x0a\x0a\x20\x20\x20\x20<p>\x0a\x20\x20\x20\x20\x20\x20With\x20these\x20changes,\x20you:\x0a\x20\x20\x20\x20</p>\x0a\x0a\x20\x20\x20\x20<ul>\x0a\x20\x20\x20\x20\x20\x20<li>\x0a\x20\x20\x20\x20\x20\x20\x20\x20Create\x20a\x20<code>names</code>\x20variable\x20as\x20a\x20slice\x20type\x20holding\x20three\x0a\x20\x20\x20\x20\x20\x20\x20\x20names.\x0a\x20\x20\x20\x20\x20\x20</li>\x0a\x20\x20\x20\x20\x20\x20<li>\x0a\x20\x20\x20\x20\x20\x20\x20\x20Pass\x20the\x20<code>names</code>\x20variable\x20as\x20the\x20argument\x20to\x20the\x0a\x20\x20\x20\x20\x20\x20\x20\x20<code>Hello</code>\x20function.\x0a\x20\x20\x20\x20\x20\x20</li>\x0a\x20\x20\x20\x20</ul>\x0a\x20\x20</li>\x0a\x0a\x20\x20<li>\x0a\x20\x20\x20\x20At\x20the\x20command\x20line,\x20change\x20to\x20the\x20directory\x20that\x20contains\x20hello/hello.go,\x0a\x20\x20\x20\x20then\x20run\x20hello.go\x20to\x20confirm\x20that\x20the\x20code\x20works.\x0a\x0a\x20\x20\x20\x20<p>\x0a\x20\x20\x20\x20\x20\x20The\x20output\x20should\x20be\x20a\x20string\x20representation\x20of\x20the\x20map\x20associating\x20names\x0a\x20\x20\x20\x20\x20\x20with\x20messages,\x20something\x20like\x20the\x20following:\x0a\x20\x20\x20\x20</p>\x0a\x0a\x20\x20\x20\x20<pre>\x0a$\x20go\x20run\x20hello.go\x0amap[Darrin:Hail,\x20Darrin!\x20Well\x20met!\x20Gladys:Hi,\x20Gladys.\x20Welcome!\x20Samantha:Hail,\x20Samantha!\x20Well\x20met!]\x0a</pre\x0a\x20\x20\x20\x20>\x0a\x20\x20</li>\x0a</ol>\x0a\x0a<p>\x0a\x20\x20This\x20topic\x20introduced\x20maps\x20for\x20representing\x20name/value\x20pairs.\x20It\x20also\x0a\x20\x20introduced\x20the\x20idea\x20of\x0a\x20\x20<a\x20href=\"https://blog.golang.org/module-compatibility\"\x0a\x20\x20\x20\x20>preserving\x20backward\x20compatibility</a\x0a\x20\x20>\x0a\x20\x20by\x20implementing\x20a\x20new\x20function\x20for\x20new\x20or\x20changed\x20functionality\x20in\x20a\x20module.\x0a\x20\x20In\x20the\x20tutorial's\x20<a\x20href=\"add-a-test.html\">next\x20topic</a>,\x20you'll\x20use\x0a\x20\x20built-in\x20features\x20to\x20create\x20a\x20unit\x20test\x20for\x20your\x20code.\x0a</p>\x0a\x0a<p\x20class=\"Navigation\">\x0a\x20\x20<a\x20class=\"Navigation-prev\"\x20href=\"random-greeting.html\"\x0a\x20\x20\x20\x20><\x20Return\x20a\x20random\x20greeting</a\x0a\x20\x20>\x0a\x20\x20<a\x20class=\"Navigation-next\"\x20href=\"add-a-test.html\">Add\x20a\x20test\x20></a>\x0a</p>\x0a",
+ "doc/tutorial/greetings-multiple-people.html": "<!--{\x0a\x20\x20\x20\x20\"Title\":\x20\"Return\x20greetings\x20for\x20multiple\x20people\",\x0a\x20\x20\x20\x20\"Path\":\x20\x20\"/doc/tutorial/greetings-multiple-people\"\x0a}-->\x0a\x0a<p>\x0a\x20\x20In\x20the\x20last\x20changes\x20you'll\x20make\x20to\x20your\x20module's\x20code,\x20you'll\x20add\x20support\x20for\x0a\x20\x20getting\x20greetings\x20for\x20multiple\x20people\x20in\x20one\x20request.\x20In\x20other\x20words,\x20you'll\x0a\x20\x20handle\x20a\x20multiple-value\x20input\x20and\x20pair\x20values\x20with\x20a\x20multiple-value\x20output.\x0a</p>\x0a\x0a<aside\x20class=\"Note\">\x0a\x20\x20<strong>Note:</strong>\x20This\x20topic\x20is\x20part\x20of\x20a\x20multi-part\x20tutorial\x20that\x20begins\x0a\x20\x20with\x20<a\x20href=\"create-module.html\">Create\x20a\x20Go\x20module</a>.\x0a</aside>\x0a\x0a<p>\x0a\x20\x20To\x20do\x20this,\x20you'll\x20need\x20to\x20pass\x20a\x20set\x20of\x20names\x20to\x20a\x20function\x20that\x20can\x20return\x20a\x0a\x20\x20greeting\x20for\x20each\x20of\x20them.\x20Changing\x20the\x20<code>Hello</code>\x20function's\x0a\x20\x20parameter\x20from\x20a\x20single\x20name\x20to\x20a\x20set\x20of\x20names\x20would\x20change\x20the\x20function\x0a\x20\x20signature.\x20If\x20you\x20had\x20already\x20published\x20the\x20<code>greetings</code>\x20module\x20and\x0a\x20\x20users\x20had\x20already\x20written\x20code\x20calling\x20<code>Hello</code>,\x20that\x20change\x20would\x0a\x20\x20break\x20their\x20programs.\x20In\x20this\x20situation,\x20a\x20better\x20choice\x20is\x20to\x20give\x20new\x0a\x20\x20functionality\x20a\x20new\x20name.\x0a</p>\x0a\x0a<p>\x0a\x20\x20In\x20the\x20last\x20code\x20you'll\x20add\x20with\x20this\x20tutorial,\x20update\x20the\x20code\x20as\x20if\x20you've\x0a\x20\x20already\x20published\x20a\x20version\x20of\x20the\x20<code>greetings</code>\x20module.\x20Instead\x20of\x0a\x20\x20changing\x20the\x20<code>Hello</code>\x20function,\x20add\x20a\x20new\x20function\x0a\x20\x20<code>Hellos</code>\x20that\x20takes\x20a\x20set\x20of\x20names.\x20Then,\x20for\x20the\x20sake\x20of\x0a\x20\x20simplicity,\x20have\x20the\x20new\x20function\x20call\x20the\x20existing\x20one.\x20Keeping\x20both\x0a\x20\x20functions\x20in\x20the\x20package\x20leaves\x20the\x20original\x20for\x20existing\x20callers\x20(or\x20future\x0a\x20\x20callers\x20who\x20only\x20need\x20one\x20greeting)\x20and\x20adds\x20a\x20new\x20one\x20for\x20callers\x20that\x20want\x0a\x20\x20the\x20expanded\x20functionality.\x0a</p>\x0a\x0a<ol>\x0a\x20\x20<li>\x0a\x20\x20\x20\x20In\x20greetings/greetings.go,\x20change\x20your\x20code\x20so\x20it\x20looks\x20like\x20the\x20following.\x0a\x0a\x20\x20\x20\x20<pre>\x0apackage\x20greetings\x0a\x0aimport\x20(\x0a\x20\x20\x20\x20\"errors\"\x0a\x20\x20\x20\x20\"fmt\"\x0a\x20\x20\x20\x20\"math/rand\"\x0a\x20\x20\x20\x20\"time\"\x0a)\x0a\x0a//\x20Hello\x20returns\x20a\x20greeting\x20for\x20the\x20named\x20person.\x0afunc\x20Hello(name\x20string)\x20(string,\x20error)\x20{\x0a\x20\x20\x20\x20//\x20If\x20no\x20name\x20was\x20given,\x20return\x20an\x20error\x20with\x20a\x20message.\x0a\x20\x20\x20\x20if\x20name\x20==\x20\"\"\x20{\x0a\x20\x20\x20\x20\x20\x20\x20\x20return\x20name,\x20errors.New(\"empty\x20name\")\x0a\x20\x20\x20\x20}\x0a\x20\x20\x20\x20//\x20Create\x20a\x20message\x20using\x20a\x20random\x20format.\x0a\x20\x20\x20\x20message\x20:=\x20fmt.Sprintf(randomFormat(),\x20name)\x0a\x20\x20\x20\x20return\x20message,\x20nil\x0a}\x0a\x0a<ins>//\x20Hellos\x20returns\x20a\x20map\x20that\x20associates\x20each\x20of\x20the\x20named\x20people\x0a//\x20with\x20a\x20greeting\x20message.\x0afunc\x20Hellos(names\x20[]string)\x20(map[string]string,\x20error)\x20{\x0a\x20\x20\x20\x20//\x20A\x20map\x20to\x20associate\x20names\x20with\x20messages.\x0a\x20\x20\x20\x20messages\x20:=\x20make(map[string]string)\x0a\x20\x20\x20\x20//\x20Loop\x20through\x20the\x20received\x20slice\x20of\x20names,\x20calling\x0a\x20\x20\x20\x20//\x20the\x20Hello\x20function\x20to\x20get\x20a\x20message\x20for\x20each\x20name.\x0a\x20\x20\x20\x20for\x20_,\x20name\x20:=\x20range\x20names\x20{\x0a\x20\x20\x20\x20\x20\x20\x20\x20message,\x20err\x20:=\x20Hello(name)\x0a\x20\x20\x20\x20\x20\x20\x20\x20if\x20err\x20!=\x20nil\x20{\x0a\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20return\x20nil,\x20err\x0a\x20\x20\x20\x20\x20\x20\x20\x20}\x0a\x20\x20\x20\x20\x20\x20\x20\x20//\x20In\x20the\x20map,\x20associate\x20the\x20retrieved\x20message\x20with\x20\x0a\x20\x20\x20\x20\x20\x20\x20\x20//\x20the\x20name.\x0a\x20\x20\x20\x20\x20\x20\x20\x20messages[name]\x20=\x20message\x0a\x20\x20\x20\x20}\x0a\x20\x20\x20\x20return\x20messages,\x20nil\x0a}</ins>\x0a\x0a//\x20Init\x20sets\x20initial\x20values\x20for\x20variables\x20used\x20in\x20the\x20function.\x0afunc\x20init()\x20{\x0a\x20\x20\x20\x20rand.Seed(time.Now().UnixNano())\x0a}\x0a\x0a//\x20randomFormat\x20returns\x20one\x20of\x20a\x20set\x20of\x20greeting\x20messages.\x20The\x20returned\x0a//\x20message\x20is\x20selected\x20at\x20random.\x0afunc\x20randomFormat()\x20string\x20{\x0a\x20\x20\x20\x20//\x20A\x20slice\x20of\x20message\x20formats.\x0a\x20\x20\x20\x20formats\x20:=\x20[]string{\x0a\x20\x20\x20\x20\x20\x20\x20\x20\"Hi,\x20%v.\x20Welcome!\",\x0a\x20\x20\x20\x20\x20\x20\x20\x20\"Great\x20to\x20see\x20you,\x20%v!\",\x0a\x20\x20\x20\x20\x20\x20\x20\x20\"Hail,\x20%v!\x20Well\x20met!\",\x0a\x20\x20\x20\x20}\x0a\x0a\x20\x20\x20\x20//\x20Return\x20one\x20of\x20the\x20message\x20formats\x20selected\x20at\x20random.\x0a\x20\x20\x20\x20return\x20formats[rand.Intn(len(formats))]\x0a}\x0a</pre>\x0a\x0a\x20\x20\x20\x20<p>\x0a\x20\x20\x20\x20\x20\x20In\x20this\x20code,\x20you:\x0a\x20\x20\x20\x20</p>\x0a\x0a\x20\x20\x20\x20<ul>\x0a\x20\x20\x20\x20\x20\x20<li>\x0a\x20\x20\x20\x20\x20\x20\x20\x20Add\x20a\x20<code>Hellos</code>\x20function\x20whose\x20parameter\x20is\x20a\x20slice\x20of\x20names\x0a\x20\x20\x20\x20\x20\x20\x20\x20rather\x20than\x20a\x20single\x20name.\x20Also,\x20you\x20change\x20one\x20of\x20its\x20return\x20types\x20from\x0a\x20\x20\x20\x20\x20\x20\x20\x20a\x20<code>string</code>\x20to\x20a\x20<code>map</code>\x20so\x20you\x20can\x20return\x20names\x0a\x20\x20\x20\x20\x20\x20\x20\x20mapped\x20to\x20greeting\x20messages.\x0a\x20\x20\x20\x20\x20\x20</li>\x0a\x20\x20\x20\x20\x20\x20<li>\x0a\x20\x20\x20\x20\x20\x20\x20\x20Have\x20the\x20new\x20Hellos\x20function\x20call\x20the\x20existing\x20Hello\x20function.\x20This\x0a\x20\x20\x20\x20\x20\x20\x20\x20leaves\x20both\x20functions\x20in\x20place.\x0a\x20\x20\x20\x20\x20\x20</li>\x0a\x20\x20\x20\x20\x20\x20<li>\x0a\x20\x20\x20\x20\x20\x20\x20\x20Create\x20a\x20<code>messages</code>\x0a\x20\x20\x20\x20\x20\x20\x20\x20<a\x20href=\"https://blog.golang.org/maps\">map</a>\x20to\x20associate\x20each\x20of\x20the\x0a\x20\x20\x20\x20\x20\x20\x20\x20received\x20names\x20(as\x20a\x20key)\x20with\x20a\x20generated\x20message\x20(as\x20a\x20value).\x20In\x20Go,\x0a\x20\x20\x20\x20\x20\x20\x20\x20you\x20initialize\x20a\x20map\x20with\x20the\x20following\x20syntax:\x0a\x20\x20\x20\x20\x20\x20\x20\x20<code>make(map[<em>key-type</em>]<em>value-type</em>)</code>.\x20You\x20have\x0a\x20\x20\x20\x20\x20\x20\x20\x20the\x20<code>Hello</code>\x20function\x20return\x20this\x20map\x20to\x20the\x20caller.\x0a\x20\x20\x20\x20\x20\x20</li>\x0a\x20\x20\x20\x20\x20\x20<li>\x0a\x20\x20\x20\x20\x20\x20\x20\x20Loop\x20through\x20the\x20names\x20your\x20function\x20received,\x20checking\x20that\x20each\x20has\x20a\x0a\x20\x20\x20\x20\x20\x20\x20\x20non-empty\x20value,\x20then\x20associate\x20a\x20message\x20with\x20each.\x20In\x20this\x0a\x20\x20\x20\x20\x20\x20\x20\x20<code>for</code>\x20loop,\x20<code>range</code>\x20returns\x20two\x20values:\x20the\x20index\x0a\x20\x20\x20\x20\x20\x20\x20\x20of\x20the\x20current\x20item\x20in\x20the\x20loop\x20and\x20a\x20copy\x20of\x20the\x20item's\x20value.\x20You\x0a\x20\x20\x20\x20\x20\x20\x20\x20don't\x20need\x20the\x20index,\x20so\x20you\x20use\x20the\x20Go\x0a\x20\x20\x20\x20\x20\x20\x20\x20<a\x20href=\"https://golang.org/doc/effective_go.html#blank\"\x0a\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20>blank\x20identifier\x20(an\x20underscore)</a\x0a\x20\x20\x20\x20\x20\x20\x20\x20>\x0a\x20\x20\x20\x20\x20\x20\x20\x20to\x20ignore\x20it.\x0a\x20\x20\x20\x20\x20\x20</li>\x0a\x20\x20\x20\x20</ul>\x0a\x20\x20</li>\x0a\x0a\x20\x20<li>\x0a\x20\x20\x20\x20In\x20your\x20hello/hello.go\x20calling\x20code,\x20pass\x20a\x20slice\x20of\x20names,\x20then\x20print\x20the\x0a\x20\x20\x20\x20contents\x20of\x20the\x20names/messages\x20map\x20you\x20get\x20back.\x0a\x0a\x20\x20\x20\x20<p>\x0a\x20\x20\x20\x20\x20\x20In\x20hello.go,\x20change\x20your\x20code\x20so\x20it\x20looks\x20like\x20the\x20following.\x0a\x20\x20\x20\x20</p>\x0a\x0a\x20\x20\x20\x20<pre>\x0apackage\x20main\x0a\x0aimport\x20(\x0a\x20\x20\x20\x20\"fmt\"\x0a\x20\x20\x20\x20\"log\"\x0a\x0a\x20\x20\x20\x20\"example.com/greetings\"\x0a)\x0a\x0afunc\x20main()\x20{\x0a\x20\x20\x20\x20//\x20Set\x20properties\x20of\x20the\x20predefined\x20Logger,\x20including\x0a\x20\x20\x20\x20//\x20the\x20log\x20entry\x20prefix\x20and\x20a\x20flag\x20to\x20disable\x20printing\x0a\x20\x20\x20\x20//\x20the\x20time,\x20source\x20file,\x20and\x20line\x20number.\x0a\x20\x20\x20\x20log.SetPrefix(\"greetings:\x20\")\x0a\x20\x20\x20\x20log.SetFlags(0)\x0a\x0a\x20\x20\x20\x20<ins>//\x20A\x20slice\x20of\x20names.\x0a\x20\x20\x20\x20names\x20:=\x20[]string{\"Gladys\",\x20\"Samantha\",\x20\"Darrin\"}</ins>\x0a\x0a\x20\x20\x20\x20//\x20Request\x20greeting\x20messages\x20for\x20the\x20names.\x0a\x20\x20\x20\x20messages,\x20err\x20:=\x20greetings.Hellos(names)\x0a\x20\x20\x20\x20if\x20err\x20!=\x20nil\x20{\x0a\x20\x20\x20\x20\x20\x20\x20\x20log.Fatal(err)\x0a\x20\x20\x20\x20}\x0a\x20\x20\x20\x20//\x20If\x20no\x20error\x20was\x20returned,\x20print\x20the\x20returned\x20map\x20of\x0a\x20\x20\x20\x20//\x20messages\x20to\x20the\x20console.\x0a\x20\x20\x20\x20fmt.Println(messages)\x0a}\x0a</pre>\x0a\x0a\x20\x20\x20\x20<p>\x0a\x20\x20\x20\x20\x20\x20With\x20these\x20changes,\x20you:\x0a\x20\x20\x20\x20</p>\x0a\x0a\x20\x20\x20\x20<ul>\x0a\x20\x20\x20\x20\x20\x20<li>\x0a\x20\x20\x20\x20\x20\x20\x20\x20Create\x20a\x20<code>names</code>\x20variable\x20as\x20a\x20slice\x20type\x20holding\x20three\x0a\x20\x20\x20\x20\x20\x20\x20\x20names.\x0a\x20\x20\x20\x20\x20\x20</li>\x0a\x20\x20\x20\x20\x20\x20<li>\x0a\x20\x20\x20\x20\x20\x20\x20\x20Pass\x20the\x20<code>names</code>\x20variable\x20as\x20the\x20argument\x20to\x20the\x0a\x20\x20\x20\x20\x20\x20\x20\x20<code>Hellos</code>\x20function.\x0a\x20\x20\x20\x20\x20\x20</li>\x0a\x20\x20\x20\x20</ul>\x0a\x20\x20</li>\x0a\x0a\x20\x20<li>\x0a\x20\x20\x20\x20At\x20the\x20command\x20line,\x20change\x20to\x20the\x20directory\x20that\x20contains\x20hello/hello.go,\x0a\x20\x20\x20\x20then\x20run\x20hello.go\x20to\x20confirm\x20that\x20the\x20code\x20works.\x0a\x0a\x20\x20\x20\x20<p>\x0a\x20\x20\x20\x20\x20\x20The\x20output\x20should\x20be\x20a\x20string\x20representation\x20of\x20the\x20map\x20associating\x20names\x0a\x20\x20\x20\x20\x20\x20with\x20messages,\x20something\x20like\x20the\x20following:\x0a\x20\x20\x20\x20</p>\x0a\x0a\x20\x20\x20\x20<pre>\x0a$\x20go\x20run\x20hello.go\x0amap[Darrin:Hail,\x20Darrin!\x20Well\x20met!\x20Gladys:Hi,\x20Gladys.\x20Welcome!\x20Samantha:Hail,\x20Samantha!\x20Well\x20met!]\x0a</pre\x0a\x20\x20\x20\x20>\x0a\x20\x20</li>\x0a</ol>\x0a\x0a<p>\x0a\x20\x20This\x20topic\x20introduced\x20maps\x20for\x20representing\x20name/value\x20pairs.\x20It\x20also\x0a\x20\x20introduced\x20the\x20idea\x20of\x0a\x20\x20<a\x20href=\"https://blog.golang.org/module-compatibility\"\x0a\x20\x20\x20\x20>preserving\x20backward\x20compatibility</a\x0a\x20\x20>\x0a\x20\x20by\x20implementing\x20a\x20new\x20function\x20for\x20new\x20or\x20changed\x20functionality\x20in\x20a\x20module.\x0a\x20\x20In\x20the\x20tutorial's\x20<a\x20href=\"add-a-test.html\">next\x20topic</a>,\x20you'll\x20use\x0a\x20\x20built-in\x20features\x20to\x20create\x20a\x20unit\x20test\x20for\x20your\x20code.\x0a</p>\x0a\x0a<p\x20class=\"Navigation\">\x0a\x20\x20<a\x20class=\"Navigation-prev\"\x20href=\"random-greeting.html\"\x0a\x20\x20\x20\x20><\x20Return\x20a\x20random\x20greeting</a\x0a\x20\x20>\x0a\x20\x20<a\x20class=\"Navigation-next\"\x20href=\"add-a-test.html\">Add\x20a\x20test\x20></a>\x0a</p>\x0a",
"doc/tutorial/handle-errors.html": "<!--{\x0a\x20\x20\x20\x20\"Title\":\x20\"Return\x20and\x20handle\x20an\x20error\",\x0a\x20\x20\x20\x20\"Path\":\x20\x20\"/doc/tutorial/handle-errors\"\x0a}-->\x0a\x0a<p>\x0a\x20\x20Handling\x20errors\x20is\x20an\x20essential\x20feature\x20of\x20solid\x20code.\x20In\x20this\x20section,\x20you'll\x0a\x20\x20add\x20a\x20bit\x20of\x20code\x20to\x20return\x20an\x20error\x20from\x20the\x20greetings\x20module,\x20then\x20handle\x20it\x0a\x20\x20in\x20the\x20caller.\x0a</p>\x0a\x0a<aside\x20class=\"Note\">\x0a\x20\x20<strong>Note:</strong>\x20This\x20topic\x20is\x20part\x20of\x20a\x20multi-part\x20tutorial\x20that\x20begins\x0a\x20\x20with\x20<a\x20href=\"create-module.html\">Create\x20a\x20Go\x20module</a>.\x0a</aside>\x0a\x0a<ol>\x0a\x20\x20<li>\x0a\x20\x20\x20\x20In\x20greetings/greetings.go,\x20add\x20the\x20code\x20highlighted\x20below.\x0a\x0a\x20\x20\x20\x20<p>\x0a\x20\x20\x20\x20\x20\x20There's\x20no\x20sense\x20sending\x20a\x20greeting\x20back\x20if\x20you\x20don't\x20know\x20who\x20to\x20greet.\x0a\x20\x20\x20\x20\x20\x20Return\x20an\x20error\x20to\x20the\x20caller\x20if\x20the\x20name\x20is\x20empty.\x20Copy\x20the\x20following\x0a\x20\x20\x20\x20\x20\x20code\x20into\x20greetings.go\x20and\x20save\x20the\x20file.\x0a\x20\x20\x20\x20</p>\x0a\x0a\x20\x20\x20\x20<pre>\x0apackage\x20greetings\x0a\x0aimport\x20(\x0a\x20\x20\x20\x20<ins>\"errors\"</ins>\x0a\x20\x20\x20\x20\"fmt\"\x0a)\x0a\x0a//\x20Hello\x20returns\x20a\x20greeting\x20for\x20the\x20named\x20person.\x0afunc\x20Hello(name\x20string)\x20<ins>(</ins>string<ins>,\x20error)</ins>\x20{\x0a\x20\x20\x20\x20<ins>//\x20If\x20no\x20name\x20was\x20given,\x20return\x20an\x20error\x20with\x20a\x20message.\x0a\x20\x20\x20\x20if\x20name\x20==\x20\"\"\x20{\x0a\x20\x20\x20\x20\x20\x20\x20\x20return\x20\"\",\x20errors.New(\"empty\x20name\")\x0a\x20\x20\x20\x20}</ins>\x0a\x0a\x20\x20\x20\x20//\x20If\x20a\x20name\x20was\x20received,\x20return\x20a\x20value\x20that\x20embeds\x20the\x20name\x20\x0a\x20\x20\x20\x20//\x20in\x20a\x20greeting\x20message.\x0a\x20\x20\x20\x20message\x20:=\x20fmt.Sprintf(\"Hi,\x20%v.\x20Welcome!\",\x20name)\x0a\x20\x20\x20\x20return\x20message<ins>,\x20nil</ins>\x0a}\x0a</pre>\x0a\x0a\x20\x20\x20\x20<p>\x0a\x20\x20\x20\x20\x20\x20In\x20this\x20code,\x20you:\x0a\x20\x20\x20\x20</p>\x0a\x0a\x20\x20\x20\x20<ul>\x0a\x20\x20\x20\x20\x20\x20<li>\x0a\x20\x20\x20\x20\x20\x20\x20\x20Change\x20the\x20function\x20so\x20that\x20it\x20returns\x20two\x20values:\x20a\x0a\x20\x20\x20\x20\x20\x20\x20\x20<code>string</code>\x20and\x20an\x20<code>error</code>.\x20Your\x20caller\x20will\x20check\x0a\x20\x20\x20\x20\x20\x20\x20\x20the\x20second\x20value\x20to\x20see\x20if\x20an\x20error\x20occurred.\x20(Any\x20Go\x20function\x20can\x0a\x20\x20\x20\x20\x20\x20\x20\x20<a\x20href=\"https://golang.org/doc/effective_go.html#multiple-returns\"\x0a\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20>return\x20multiple\x20values</a\x0a\x20\x20\x20\x20\x20\x20\x20\x20>.)\x0a\x20\x20\x20\x20\x20\x20</li>\x0a\x20\x20\x20\x20\x20\x20<li>\x0a\x20\x20\x20\x20\x20\x20\x20\x20Import\x20the\x20Go\x20standard\x20library\x20<code>errors</code>\x20package\x20so\x20you\x20can\x0a\x20\x20\x20\x20\x20\x20\x20\x20use\x20its\x0a\x20\x20\x20\x20\x20\x20\x20\x20<a\x20href=\"https://golang.org/pkg/errors/#example_New\"\x0a\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20><code>errors.New</code>\x20function</a\x0a\x20\x20\x20\x20\x20\x20\x20\x20>.\x0a\x20\x20\x20\x20\x20\x20</li>\x0a\x20\x20\x20\x20\x20\x20<li>\x0a\x20\x20\x20\x20\x20\x20\x20\x20Add\x20an\x20<code>if</code>\x20statement\x20to\x20check\x20for\x20an\x20invalid\x20request\x20(an\x0a\x20\x20\x20\x20\x20\x20\x20\x20empty\x20string\x20where\x20the\x20name\x20should\x20be)\x20and\x20return\x20an\x20error\x20if\x20the\x0a\x20\x20\x20\x20\x20\x20\x20\x20request\x20is\x20invalid.\x20The\x20<code>errors.New</code>\x20function\x20returns\x20an\x0a\x20\x20\x20\x20\x20\x20\x20\x20<code>error</code>\x20with\x20your\x20message\x20inside.\x0a\x20\x20\x20\x20\x20\x20</li>\x0a\x20\x20\x20\x20\x20\x20<li>\x0a\x20\x20\x20\x20\x20\x20\x20\x20Add\x20<code>nil</code>\x20(meaning\x20no\x20error)\x20as\x20a\x20second\x20value\x20in\x20the\x0a\x20\x20\x20\x20\x20\x20\x20\x20successful\x20return.\x20That\x20way,\x20the\x20caller\x20can\x20see\x20that\x20the\x20function\x0a\x20\x20\x20\x20\x20\x20\x20\x20succeeded.\x0a\x20\x20\x20\x20\x20\x20</li>\x0a\x20\x20\x20\x20</ul>\x0a\x20\x20</li>\x0a\x0a\x20\x20<li>\x0a\x20\x20\x20\x20In\x20your\x20hello/hello.go\x20file,\x20handle\x20the\x20error\x20now\x20returned\x20by\x20the\x0a\x20\x20\x20\x20<code>Hello</code>\x20function,\x20along\x20with\x20the\x20non-error\x20value.\x0a\x0a\x20\x20\x20\x20<p>\x0a\x20\x20\x20\x20\x20\x20Paste\x20the\x20following\x20code\x20into\x20hello.go.\x0a\x20\x20\x20\x20</p>\x0a\x0a\x20\x20\x20\x20<pre>\x0apackage\x20main\x0a\x0aimport\x20(\x0a\x20\x20\x20\x20\"fmt\"\x0a\x20\x20\x20\x20<ins>\"log\"</ins>\x0a\x0a\x20\x20\x20\x20\"example.com/greetings\"\x0a)\x0a\x0afunc\x20main()\x20{\x0a\x20\x20\x20\x20<ins>//\x20Set\x20properties\x20of\x20the\x20predefined\x20Logger,\x20including\x0a\x20\x20\x20\x20//\x20the\x20log\x20entry\x20prefix\x20and\x20a\x20flag\x20to\x20disable\x20printing\x0a\x20\x20\x20\x20//\x20the\x20time,\x20source\x20file,\x20and\x20line\x20number.\x0a\x20\x20\x20\x20log.SetPrefix(\"greetings:\x20\")\x0a\x20\x20\x20\x20log.SetFlags(0)</ins>\x0a\x0a\x20\x20\x20\x20//\x20Request\x20a\x20greeting\x20message.\x0a\x20\x20\x20\x20message,\x20err\x20:=\x20greetings.Hello(\"\")\x0a\x20\x20\x20\x20<ins>//\x20If\x20an\x20error\x20was\x20returned,\x20print\x20it\x20to\x20the\x20console\x20and\x0a\x20\x20\x20\x20//\x20exit\x20the\x20program.\x0a\x20\x20\x20\x20if\x20err\x20!=\x20nil\x20{\x0a\x20\x20\x20\x20\x20\x20\x20\x20log.Fatal(err)\x0a\x20\x20\x20\x20}\x0a\x0a\x20\x20\x20\x20//\x20If\x20no\x20error\x20was\x20returned,\x20print\x20the\x20returned\x20message\x0a\x20\x20\x20\x20//\x20to\x20the\x20console.</ins>\x0a\x20\x20\x20\x20fmt.Println(message)\x0a}\x0a</pre>\x0a\x0a\x20\x20\x20\x20<p>\x0a\x20\x20\x20\x20\x20\x20In\x20this\x20code,\x20you:\x0a\x20\x20\x20\x20</p>\x0a\x0a\x20\x20\x20\x20<ul>\x0a\x20\x20\x20\x20\x20\x20<li>\x0a\x20\x20\x20\x20\x20\x20\x20\x20Configure\x20the\x0a\x20\x20\x20\x20\x20\x20\x20\x20<a\x20href=\"https://golang.org/pkg/log/\"><code>log</code>\x20package</a>\x20to\x0a\x20\x20\x20\x20\x20\x20\x20\x20print\x20the\x20command\x20name\x20(\"greetings:\x20\")\x20at\x20the\x20start\x20of\x20its\x20log\x20messages,\x0a\x20\x20\x20\x20\x20\x20\x20\x20without\x20a\x20time\x20stamp\x20or\x20source\x20file\x20information.\x0a\x20\x20\x20\x20\x20\x20</li>\x0a\x20\x20\x20\x20\x20\x20<li>\x0a\x20\x20\x20\x20\x20\x20\x20\x20Assign\x20both\x20of\x20the\x20<code>Hello</code>\x20return\x20values,\x20including\x20the\x0a\x20\x20\x20\x20\x20\x20\x20\x20<code>error</code>,\x20to\x20variables.\x0a\x20\x20\x20\x20\x20\x20</li>\x0a\x20\x20\x20\x20\x20\x20<li>\x0a\x20\x20\x20\x20\x20\x20\x20\x20Change\x20the\x20<code>Hello</code>\x20argument\x20from\x20Gladys\xe2\x80\x99s\x20name\x20to\x20an\x20empty\x0a\x20\x20\x20\x20\x20\x20\x20\x20string,\x20so\x20you\x20can\x20try\x20out\x20your\x20error-handling\x20code.\x0a\x20\x20\x20\x20\x20\x20</li>\x0a\x20\x20\x20\x20\x20\x20<li>\x0a\x20\x20\x20\x20\x20\x20\x20\x20Look\x20for\x20a\x20non-nil\x20<code>error</code>\x20value.\x20There's\x20no\x20sense\x20continuing\x0a\x20\x20\x20\x20\x20\x20\x20\x20in\x20this\x20case.\x0a\x20\x20\x20\x20\x20\x20</li>\x0a\x20\x20\x20\x20\x20\x20<li>\x0a\x20\x20\x20\x20\x20\x20\x20\x20Use\x20the\x20functions\x20in\x20the\x20standard\x20library's\x20<code>log\x20package</code>\x20to\x0a\x20\x20\x20\x20\x20\x20\x20\x20output\x20error\x20information.\x20If\x20you\x20get\x20an\x20error,\x20you\x20use\x20the\x0a\x20\x20\x20\x20\x20\x20\x20\x20<code>log</code>\x20package's\x0a\x20\x20\x20\x20\x20\x20\x20\x20<a\x20href=\"https://pkg.go.dev/log?tab=doc#Fatal\"\x0a\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20><code>Fatal</code>\x20function</a\x0a\x20\x20\x20\x20\x20\x20\x20\x20>\x0a\x20\x20\x20\x20\x20\x20\x20\x20to\x20print\x20the\x20error\x20and\x20stop\x20the\x20program.\x0a\x20\x20\x20\x20\x20\x20</li>\x0a\x20\x20\x20\x20</ul>\x0a\x20\x20</li>\x0a\x0a\x20\x20<li>\x0a\x20\x20\x20\x20At\x20the\x20command\x20line\x20in\x20the\x20<code>hello</code>\x20directory,\x20run\x20hello.go\x20to\x0a\x20\x20\x20\x20confirm\x20that\x20the\x20code\x20works.\x0a\x0a\x20\x20\x20\x20<p>\x0a\x20\x20\x20\x20\x20\x20Now\x20that\x20you're\x20passing\x20in\x20an\x20empty\x20name,\x20you'll\x20get\x20an\x20error.\x0a\x20\x20\x20\x20</p>\x0a\x0a\x20\x20\x20\x20<pre>\x0a$\x20go\x20run\x20hello.go\x0agreetings:\x20empty\x20name\x0aexit\x20status\x201\x0a</pre\x0a\x20\x20\x20\x20>\x0a\x20\x20</li>\x0a</ol>\x0a\x0a<p>\x0a\x20\x20That's\x20essentially\x20how\x20error\x20handling\x20in\x20Go\x20works:\x20Return\x20an\x20error\x20as\x20a\x20value\x0a\x20\x20so\x20the\x20caller\x20can\x20check\x20for\x20it.\x20It's\x20pretty\x20simple.\x20In\x20the\x20tutorial's\x0a\x20\x20<a\x20href=\"random-greeting.html\">next\x20topic</a>,\x20you'll\x20use\x20a\x20Go\x20slice\x20to\x20return\x0a\x20\x20a\x20randomly-selected\x20greeting.\x0a</p>\x0a\x0a<p\x20class=\"Navigation\">\x0a\x20\x20<a\x20class=\"Navigation-prev\"\x20href=\"call-module-code.html\"\x0a\x20\x20\x20\x20><\x20Call\x20your\x20code\x20from\x20another\x20module</a\x0a\x20\x20>\x0a\x20\x20<a\x20class=\"Navigation-next\"\x20href=\"random-greeting.html\"\x0a\x20\x20\x20\x20>Return\x20a\x20random\x20greeting\x20></a\x0a\x20\x20>\x0a</p>\x0a",
