content/static/doc/tutorial: fix duplicate description
The previous text appears to be referring to the next item in the
list. This updates the alt text to refer to the correct tutorial.
Fixes golang/go#41218
Change-Id: I24d910a6a37b58ced8febfa99bf89f23126d4f18
GitHub-Last-Rev: 77107311247fc5770a09b6913a59edf7844a6371
GitHub-Pull-Request: golang/website#14
Reviewed-on: https://go-review.googlesource.com/c/website/+/253117
Run-TryBot: Dmitri Shuralyov <dmitshur@golang.org>
TryBot-Result: Gobot Gobot <gobot@golang.org>
Reviewed-by: Dmitri Shuralyov <dmitshur@golang.org>
diff --git a/content/static/doc/tutorial/create-module.html b/content/static/doc/tutorial/create-module.html
index eb26c9a..44e0d83 100644
--- a/content/static/doc/tutorial/create-module.html
+++ b/content/static/doc/tutorial/create-module.html
@@ -29,7 +29,7 @@
</li>
<li>
<a href="call-module-code.html">Call your code from another module</a> --
- Add simple error handling.
+ Import and use your new module.
</li>
<li>
<a href="handle-errors.html">Return and handle an error</a> -- Add simple
diff --git a/content/static/static.go b/content/static/static.go
index cb21200..0b979d8 100644
--- a/content/static/static.go
+++ b/content/static/static.go
@@ -91,7 +91,7 @@
"doc/tutorial/compile-install.html": "<!--{\x0a\x20\x20\x20\x20\"Title\":\x20\"Compile\x20and\x20install\x20the\x20application\",\x0a\x20\x20\x20\x20\"Path\":\x20\x20\"/doc/tutorial/compile-install\"\x0a}-->\x0a\x0a<p>\x0a\x20\x20In\x20the\x20last\x20section,\x20you'll\x20learn\x20a\x20new\x20<code>go</code>\x20command.\x20While\x20the\x0a\x20\x20<code>go\x20run</code>\x20command\x20is\x20a\x20useful\x20shortcut\x20for\x20compiling\x20and\x20running\x20a\x0a\x20\x20single-file\x20program,\x20it\x20doesn't\x20generate\x20a\x20binary\x20executable\x20you\x20can\x20easily\x0a\x20\x20run\x20again.\x20If\x20you\x20want\x20one\x20of\x20those,\x20a\x20good\x20choice\x20is\x20to\x20run\x20the\x0a\x20\x20<a\x0a\x20\x20\x20\x20href=\"https://golang.org/cmd/go/#hdr-Compile_and_install_packages_and_dependencies\"\x0a\x20\x20\x20\x20><code>go\x20install</code>\x20command</a\x0a\x20\x20>,\x20which\x20compiles\x20your\x20code\x20and\x20installs\x20the\x20resulting\x20binary\x20executable\x20where\x0a\x20\x20you\x20can\x20run\x20it.\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\x20At\x20the\x20command\x20line,\x20change\x20to\x20the\x20directory\x20that\x20contains\x20hello/hello.go.\x0a\x20\x20</li>\x0a\x0a\x20\x20<li>\x0a\x20\x20\x20\x20Discover\x20the\x20Go\x20install\x20path,\x20where\x20the\x20<code>go</code>\x20command\x20will\x20install\x0a\x20\x20\x20\x20the\x20current\x20package.\x0a\x0a\x20\x20\x20\x20<p>\x0a\x20\x20\x20\x20\x20\x20You\x20can\x20discover\x20the\x20install\x20path\x20by\x20running\x20the\x0a\x20\x20\x20\x20\x20\x20<a\x20href=\"https://golang.org/cmd/go/#hdr-List_packages_or_modules\"\x0a\x20\x20\x20\x20\x20\x20\x20\x20><code>go\x20list</code>\x20command</a\x0a\x20\x20\x20\x20\x20\x20>,\x20as\x20in\x20the\x20following\x20example:\x0a\x20\x20\x20\x20</p>\x0a\x0a\x20\x20\x20\x20<pre>\x0ago\x20list\x20-f\x20'{{.Target}}'\x0a</pre\x0a\x20\x20\x20\x20>\x0a\x0a\x20\x20\x20\x20<p>\x0a\x20\x20\x20\x20\x20\x20For\x20example,\x20the\x20command's\x20output\x20might\x20say\x0a\x20\x20\x20\x20\x20\x20<code>/home/gopher/bin/hello</code>,\x20meaning\x20that\x20binaries\x20are\x20installed\x0a\x20\x20\x20\x20\x20\x20to\x20/home/gopher/bin.\x20This\x20is\x20the\x20install\x20directory\x20you'll\x20need\x20in\x20the\x20next\x0a\x20\x20\x20\x20\x20\x20step.\x0a\x20\x20\x20\x20</p>\x0a\x20\x20</li>\x0a\x0a\x20\x20<li>\x0a\x20\x20\x20\x20Add\x20the\x20Go\x20install\x20directory\x20to\x20your\x20system's\x20shell\x20path.\x0a\x0a\x20\x20\x20\x20<p>\x0a\x20\x20\x20\x20\x20\x20That\x20way,\x20you'll\x20be\x20able\x20to\x20run\x20your\x20program's\x20executable\x20without\x0a\x20\x20\x20\x20\x20\x20specifying\x20where\x20the\x20executable\x20is.\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\x20On\x20Linux\x20or\x20Mac,\x20run\x20the\x20following\x20command:\x0a\x0a\x20\x20\x20\x20\x20\x20\x20\x20<pre>\x0aexport\x20PATH=$PATH:/path/to/your/install/directory\x0a</pre\x0a\x20\x20\x20\x20\x20\x20\x20\x20>\x0a\x20\x20\x20\x20\x20\x20</li>\x0a\x0a\x20\x20\x20\x20\x20\x20<li>\x0a\x20\x20\x20\x20\x20\x20\x20\x20On\x20Windows,\x20run\x20the\x20following\x20command:\x0a\x0a\x20\x20\x20\x20\x20\x20\x20\x20<pre>\x0aset\x20PATH=%PATH%;C:\\path\\to\\your\\install\\directory\x0a</pre\x0a\x20\x20\x20\x20\x20\x20\x20\x20>\x0a\x20\x20\x20\x20\x20\x20</li>\x0a\x20\x20\x20\x20</ul>\x0a\x0a\x20\x20\x20\x20<p>\x0a\x20\x20\x20\x20\x20\x20As\x20an\x20alternative,\x20if\x20you\x20already\x20have\x20a\x20directory\x20like\x0a\x20\x20\x20\x20\x20\x20<code>$HOME/bin</code>\x20in\x20your\x20shell\x20path\x20and\x20you'd\x20like\x20to\x20install\x20your\x0a\x20\x20\x20\x20\x20\x20Go\x20programs\x20there,\x20you\x20can\x20change\x20the\x20install\x20target\x20by\x20setting\x20the\x20GOBIN\x0a\x20\x20\x20\x20\x20\x20variable\x20using\x20the\x0a\x20\x20\x20\x20\x20\x20<a\x20href=\"https://golang.org/cmd/go/#hdr-Print_Go_environment_information\"\x0a\x20\x20\x20\x20\x20\x20\x20\x20><code>go\x20env</code>\x20command</a\x0a\x20\x20\x20\x20\x20\x20>:\x0a\x20\x20\x20\x20</p>\x0a\x0a\x20\x20\x20\x20<pre>\x0ago\x20env\x20-w\x20GOBIN=/path/to/your/bin\x0a</pre\x0a\x20\x20\x20\x20>\x0a\x0a\x20\x20\x20\x20<p>\x0a\x20\x20\x20\x20\x20\x20or\x0a\x20\x20\x20\x20</p>\x0a\x0a\x20\x20\x20\x20<pre>\x0ago\x20env\x20-w\x20GOBIN=C:\\path\\to\\your\\bin\x0a</pre\x0a\x20\x20\x20\x20>\x0a\x20\x20</li>\x0a\x0a\x20\x20<li>\x0a\x20\x20\x20\x20Once\x20you've\x20updated\x20the\x20shell\x20path,\x20run\x20the\x20<code>go\x20install</code>\x20command\x0a\x20\x20\x20\x20to\x20compile\x20and\x20install\x20the\x20package.\x0a\x0a\x20\x20\x20\x20<pre>\x0a$\x20go\x20install\x0a</pre\x0a\x20\x20\x20\x20>\x0a\x20\x20</li>\x0a\x0a\x20\x20<li>\x0a\x20\x20\x20\x20Run\x20your\x20application\x20by\x20simply\x20typing\x20its\x20name.\x0a\x0a\x20\x20\x20\x20<pre>\x0a$\x20hello\x0amap[Darrin:Hail,\x20Darrin!\x20Well\x20met!\x20Gladys:Great\x20to\x20see\x20you,\x20Gladys!\x20Samantha:Hail,\x20Samantha!\x20Well\x20met!]\x0a</pre\x0a\x20\x20\x20\x20>\x0a\x20\x20</li>\x0a</ol>\x0a\x0a<p>\x0a\x20\x20That\x20wraps\x20up\x20this\x20Go\x20tutorial!\x20For\x20a\x20next\x20step\x20that\x20introduces\x20many\x20more\x20of\x0a\x20\x20Go\x20features,\x20check\x20out\x20the\x0a\x20\x20<a\x20href=\"https://tour.golang.org/welcome/1\">Tour\x20of\x20Go</a>.\x0a</p>\x0a\x0a<p\x20class=\"Navigation\">\x0a\x20\x20<a\x20class=\"Navigation-prev\"\x20href=\"add-a-test.html\"><\x20Add\x20a\x20test</a>\x0a</p>\x0a",
- "doc/tutorial/create-module.html": "<!--{\x0a\x20\x20\x20\x20\"Title\":\x20\"Tutorial:\x20Create\x20a\x20Go\x20module\",\x0a\x20\x20\x20\x20\"Path\":\x20\x20\"/doc/tutorial/create-module\"\x0a}-->\x0a\x0a<p>\x0a\x20\x20This\x20is\x20the\x20first\x20part\x20of\x20a\x20tutorial\x20that\x20introduces\x20a\x20few\x20fundamental\x0a\x20\x20features\x20of\x20the\x20Go\x20language.\x20If\x20you're\x20just\x20getting\x20started\x20with\x20Go,\x20be\x20sure\x0a\x20\x20to\x20take\x20a\x20look\x20at\x20the\x0a\x20\x20<a\x20href=\"getting-started.html\">getting\x20started</a>\x20tutorial,\x20which\x20introduces\x0a\x20\x20the\x20<code>go</code>\x20command,\x20Go\x20modules,\x20and\x20very\x20simple\x20Go\x20code.\x0a</p>\x0a\x0a<p>\x0a\x20\x20In\x20this\x20tutorial\x20you'll\x20create\x20two\x20modules.\x20The\x20first\x20is\x20a\x20library\x20which\x20is\x0a\x20\x20intended\x20to\x20be\x20imported\x20by\x20other\x20libraries\x20or\x20applications.\x20The\x20second\x20is\x20a\x0a\x20\x20caller\x20application\x20which\x20will\x20use\x20the\x20first.\x0a</p>\x0a\x0a<p>\x0a\x20\x20This\x20tutorial's\x20sequence\x20includes\x20six\x20brief\x20topics\x20that\x20each\x20illustrate\x20a\x0a\x20\x20different\x20part\x20of\x20the\x20language.\x0a</p>\x0a\x0a<ol>\x0a\x20\x20<li>\x0a\x20\x20\x20\x20Create\x20a\x20module\x20--\x20Write\x20a\x20small\x20module\x20with\x20functions\x20you\x20can\x20call\x20from\x0a\x20\x20\x20\x20another\x20module.\x0a\x20\x20</li>\x0a\x20\x20<li>\x0a\x20\x20\x20\x20<a\x20href=\"call-module-code.html\">Call\x20your\x20code\x20from\x20another\x20module</a>\x20--\x0a\x20\x20\x20\x20Add\x20simple\x20error\x20handling.\x0a\x20\x20</li>\x0a\x20\x20<li>\x0a\x20\x20\x20\x20<a\x20href=\"handle-errors.html\">Return\x20and\x20handle\x20an\x20error</a>\x20--\x20Add\x20simple\x0a\x20\x20\x20\x20error\x20handling.\x0a\x20\x20</li>\x0a\x20\x20<li>\x0a\x20\x20\x20\x20<a\x20href=\"random-greeting.html\">Return\x20a\x20random\x20greeting</a>\x20--\x20Handle\x20data\x0a\x20\x20\x20\x20in\x20slices\x20(Go's\x20dynamically-sized\x20arrays).\x0a\x20\x20</li>\x0a\x20\x20<li>\x0a\x20\x20\x20\x20<a\x20href=\"greetings-multiple-people.html\"\x0a\x20\x20\x20\x20\x20\x20>Return\x20greetings\x20for\x20multiple\x20people</a\x0a\x20\x20\x20\x20>\x0a\x20\x20\x20\x20--\x20Store\x20key/value\x20pairs\x20in\x20a\x20map.\x0a\x20\x20</li>\x0a\x20\x20<li>\x0a\x20\x20\x20\x20<a\x20href=\"add-a-test.html\">Add\x20a\x20test</a>\x20--\x20Use\x20Go's\x20built-in\x20unit\x20testing\x0a\x20\x20\x20\x20features\x20to\x20test\x20your\x20code.\x0a\x20\x20</li>\x0a\x20\x20<li>\x0a\x20\x20\x20\x20<a\x20href=\"compile-install.html\">Compile\x20and\x20install\x20the\x20application</a>\x20--\x0a\x20\x20\x20\x20Compile\x20and\x20install\x20your\x20code\x20locally.\x0a\x20\x20</li>\x0a</ol>\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,\x20loops,\x20and\x20arrays.\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=\"start\">Start\x20a\x20module\x20that\x20others\x20can\x20use</h2>\x0a\x0a<p>\x0a\x20\x20Start\x20by\x20creating\x20a\x0a\x20\x20<a\x20href=\"https://golang.org/doc/code.html#Organization\">Go\x20module</a>.\x20In\x20a\x0a\x20\x20module,\x20you\x20collect\x20one\x20or\x20more\x20related\x20packages\x20for\x20a\x20discrete\x20and\x20useful\x20set\x0a\x20\x20of\x20functions.\x20For\x20example,\x20you\x20might\x20create\x20a\x20module\x20with\x20packages\x20that\x20have\x0a\x20\x20functions\x20for\x20doing\x20financial\x20analysis\x20so\x20that\x20others\x20writing\x20financial\x0a\x20\x20applications\x20can\x20use\x20your\x20work.\x0a</p>\x0a\x0a<p>\x0a\x20\x20Go\x20code\x20is\x20grouped\x20into\x20packages,\x20and\x20packages\x20are\x20grouped\x20into\x20modules.\x20Your\x0a\x20\x20package's\x20module\x20specifies\x20the\x20context\x20Go\x20needs\x20to\x20run\x20the\x20code,\x20including\x20the\x0a\x20\x20Go\x20version\x20the\x20code\x20is\x20written\x20for\x20and\x20the\x20set\x20of\x20other\x20modules\x20it\x20requires.\x0a</p>\x0a\x0a<p>\x0a\x20\x20As\x20you\x20add\x20or\x20improve\x20functionality\x20in\x20your\x20module,\x20you\x20publish\x20new\x20versions\x0a\x20\x20of\x20the\x20module.\x20Developers\x20writing\x20code\x20that\x20calls\x20functions\x20in\x20your\x20module\x20can\x0a\x20\x20import\x20the\x20module's\x20updated\x20packages\x20and\x20test\x20with\x20the\x20new\x20version\x20before\x0a\x20\x20putting\x20it\x20into\x20production\x20use.\x0a</p>\x0a\x0a<ol>\x0a\x20\x20<li>\x0a\x20\x20\x20\x20Open\x20a\x20command\x20prompt\x20and\x20<code>cd</code>\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\x20<code>greetings</code>\x20directory\x20for\x20your\x20Go\x20module\x20source\x20code.\x0a\x20\x20\x20\x20This\x20is\x20where\x20you'll\x20write\x20your\x20module\x20code.\x0a\x0a\x20\x20\x20\x20<p>\x0a\x20\x20\x20\x20\x20\x20For\x20example,\x20from\x20your\x20home\x20directory\x20use\x20the\x20following\x20commands:\x0a\x20\x20\x20\x20</p>\x0a\x0a\x20\x20\x20\x20<pre>\x0amkdir\x20greetings\x0acd\x20greetings\x0a</pre\x0a\x20\x20\x20\x20>\x0a\x20\x20</li>\x0a\x0a\x20\x20<li>\x0a\x20\x20\x20\x20Start\x20your\x20module\x20using\x20the\x0a\x20\x20\x20\x20<a\x0a\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><code>go\x20mod\x20init</code>\x20command</a\x0a\x20\x20\x20\x20>\x0a\x20\x20\x20\x20to\x20create\x20a\x20go.mod\x20file.\x0a\x0a\x20\x20\x20\x20<p>\x0a\x20\x20\x20\x20\x20\x20Run\x20the\x20<code>go\x20mod\x20init</code>\x20command,\x20giving\x20it\x20the\x20path\x20of\x20the\x20module\x0a\x20\x20\x20\x20\x20\x20your\x20code\x20will\x20be\x20in.\x20Here,\x20use\x20<code>example.com/greetings</code>\x20for\x20the\x0a\x20\x20\x20\x20\x20\x20module\x20path\x20--\x20in\x20production\x20code,\x20this\x20would\x20be\x20the\x20URL\x20from\x20which\x20your\x0a\x20\x20\x20\x20\x20\x20module\x20can\x20be\x20downloaded.\x0a\x20\x20\x20\x20</p>\x0a\x0a\x20\x20\x20\x20<pre>\x0a$\x20go\x20mod\x20init\x20example.com/greetings\x0ago:\x20creating\x20new\x20go.mod:\x20module\x20example.com/greetings\x0a</pre\x0a\x20\x20\x20\x20>\x0a\x0a\x20\x20\x20\x20<p>\x0a\x20\x20\x20\x20\x20\x20The\x20<code>go\x20mod\x20init</code>\x20command\x20creates\x20a\x20go.mod\x20file\x20that\x20identifies\x0a\x20\x20\x20\x20\x20\x20your\x20code\x20as\x20a\x20module\x20that\x20might\x20be\x20used\x20from\x20other\x20code.\x20The\x20file\x20you\x0a\x20\x20\x20\x20\x20\x20just\x20created\x20includes\x20only\x20the\x20name\x20of\x20your\x20module\x20and\x20the\x20Go\x20version\x20your\x0a\x20\x20\x20\x20\x20\x20code\x20supports.\x20But\x20as\x20you\x20add\x20dependencies\x20--\x20meaning\x20packages\x20from\x20other\x0a\x20\x20\x20\x20\x20\x20modules\x20--\x20the\x20go.mod\x20file\x20will\x20list\x20the\x20specific\x20module\x20versions\x20to\x20use.\x0a\x20\x20\x20\x20\x20\x20This\x20keeps\x20builds\x20reproducible\x20and\x20gives\x20you\x20direct\x20control\x20over\x20which\x0a\x20\x20\x20\x20\x20\x20module\x20versions\x20to\x20use.\x0a\x20\x20\x20\x20</p>\x0a\x20\x20</li>\x0a\x0a\x20\x20<li>\x0a\x20\x20\x20\x20In\x20your\x20text\x20editor,\x20create\x20a\x20file\x20in\x20which\x20to\x20write\x20your\x20code\x20and\x20call\x20it\x0a\x20\x20\x20\x20greetings.go.\x0a\x20\x20</li>\x0a\x0a\x20\x20<li>\x0a\x20\x20\x20\x20Paste\x20the\x20following\x20code\x20into\x20your\x20greetings.go\x20file\x20and\x20save\x20the\x20file.\x0a\x0a\x20\x20\x20\x20<pre>\x0apackage\x20greetings\x0a\x0aimport\x20\"fmt\"\x0a\x0a//\x20Hello\x20returns\x20a\x20greeting\x20for\x20the\x20named\x20person.\x0afunc\x20Hello(name\x20string)\x20string\x20{\x0a\x20\x20\x20\x20//\x20Return\x20a\x20greeting\x20that\x20embeds\x20the\x20name\x20in\x20a\x20message.\x0a\x20\x20\x20\x20message\x20:=\x20fmt.Sprintf(\"Hi,\x20%v.\x20Welcome!\",\x20name)\x0a\x20\x20\x20\x20return\x20message\x0a}\x0a</pre\x0a\x20\x20\x20\x20>\x0a\x0a\x20\x20\x20\x20<p>\x0a\x20\x20\x20\x20\x20\x20This\x20is\x20the\x20first\x20code\x20for\x20your\x20module.\x20It\x20returns\x20a\x20greeting\x20to\x20any\x0a\x20\x20\x20\x20\x20\x20caller\x20that\x20asks\x20for\x20one.\x20You'll\x20write\x20code\x20that\x20calls\x20this\x20function\x20in\x0a\x20\x20\x20\x20\x20\x20the\x20next\x20step.\x0a\x20\x20\x20\x20</p>\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\x20Declare\x20a\x20<code>greetings</code>\x20package\x20to\x20collect\x20related\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\x20Implement\x20a\x20<code>Hello</code>\x20function\x20to\x20return\x20the\x20greeting.\x0a\x20\x20\x20\x20\x20\x20\x20\x20<p>\x0a\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20This\x20function\x20takes\x20a\x20<code>name</code>\x20parameter\x20whose\x20type\x20is\x0a\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20<code>string</code>,\x20and\x20returns\x20a\x20<code>string</code>.\x20In\x20Go,\x20a\x0a\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20function\x20whose\x20name\x20starts\x20with\x20a\x20capital\x20letter\x20can\x20be\x20called\x20by\x20a\x0a\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20function\x20not\x20in\x20the\x20same\x20package.\x20This\x20is\x20known\x20in\x20Go\x20as\x20an\x0a\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20<a\x20href=\"https://tour.golang.org/basics/3\"><em>exported</em>\x20name</a>.\x0a\x20\x20\x20\x20\x20\x20\x20\x20</p>\x0a\x20\x20\x20\x20\x20\x20\x20\x20<img\x20src=\"images/function-syntax.png\"\x20width=\"300px\"\x20/>\x0a\x20\x20\x20\x20\x20\x20</li>\x0a\x0a\x20\x20\x20\x20\x20\x20<li>\x0a\x20\x20\x20\x20\x20\x20\x20\x20Declare\x20a\x20<code>message</code>\x20variable\x20to\x20hold\x20your\x20greeting.\x0a\x20\x20\x20\x20\x20\x20\x20\x20<p>\x0a\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20In\x20Go,\x20the\x20<code>:=</code>\x20operator\x20is\x20a\x20shortcut\x20for\x20declaring\x20and\x0a\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20initializing\x20a\x20variable\x20in\x20one\x20line\x20(Go\x20uses\x20the\x20value\x20on\x20the\x20right\x20to\x0a\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20determine\x20the\x20variable's\x20type).\x20Taking\x20the\x20long\x20way,\x20you\x20might\x20have\x0a\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20written\x20this\x20as:\x0a\x20\x20\x20\x20\x20\x20\x20\x20</p>\x0a\x20\x20\x20\x20\x20\x20\x20\x20<pre>\x0avar\x20message\x20string\x0amessage\x20=\x20fmt.Sprintf(\"Hi,\x20%v.\x20Welcome!\",\x20name)\x0a</pre\x0a\x20\x20\x20\x20\x20\x20\x20\x20>\x0a\x20\x20\x20\x20\x20\x20</li>\x0a\x0a\x20\x20\x20\x20\x20\x20<li>\x0a\x20\x20\x20\x20\x20\x20\x20\x20Use\x20the\x20<code>fmt</code>\x20package's\x20<code>Sprintf</code>\x20function\x20to\x0a\x20\x20\x20\x20\x20\x20\x20\x20create\x20a\x20greeting\x20message.\x20The\x20first\x20argument\x20is\x20a\x20format\x20string,\x20and\x0a\x20\x20\x20\x20\x20\x20\x20\x20<code>Sprintf</code>\x20substitutes\x20the\x20<code>name</code>\x20parameter's\x20value\x0a\x20\x20\x20\x20\x20\x20\x20\x20for\x20the\x20<code>%v</code>\x20format\x20verb.\x20Inserting\x20the\x20value\x20of\x20the\x0a\x20\x20\x20\x20\x20\x20\x20\x20<code>name</code>\x20parameter\x20completes\x20the\x20greeting\x20text.\x0a\x20\x20\x20\x20\x20\x20</li>\x0a\x20\x20\x20\x20\x20\x20<li>Return\x20the\x20formatted\x20greeting\x20text\x20to\x20the\x20caller.</li>\x0a\x20\x20\x20\x20</ul>\x0a\x20\x20</li>\x0a</ol>\x0a\x0a<p>\x0a\x20\x20In\x20the\x20<a\x20href=\"call-module-code.html\">next\x20step</a>,\x20you'll\x20call\x20this\x0a\x20\x20function\x20from\x20another\x20module.\x0a</p>\x0a\x0a<p\x20class=\"Navigation\">\x0a\x20\x20<a\x20class=\"Navigation-next\"\x20href=\"call-module-code.html\"\x0a\x20\x20\x20\x20>Call\x20your\x20code\x20from\x20another\x20module\x20></a\x0a\x20\x20>\x0a</p>\x0a",
+ "doc/tutorial/create-module.html": "<!--{\x0a\x20\x20\x20\x20\"Title\":\x20\"Tutorial:\x20Create\x20a\x20Go\x20module\",\x0a\x20\x20\x20\x20\"Path\":\x20\x20\"/doc/tutorial/create-module\"\x0a}-->\x0a\x0a<p>\x0a\x20\x20This\x20is\x20the\x20first\x20part\x20of\x20a\x20tutorial\x20that\x20introduces\x20a\x20few\x20fundamental\x0a\x20\x20features\x20of\x20the\x20Go\x20language.\x20If\x20you're\x20just\x20getting\x20started\x20with\x20Go,\x20be\x20sure\x0a\x20\x20to\x20take\x20a\x20look\x20at\x20the\x0a\x20\x20<a\x20href=\"getting-started.html\">getting\x20started</a>\x20tutorial,\x20which\x20introduces\x0a\x20\x20the\x20<code>go</code>\x20command,\x20Go\x20modules,\x20and\x20very\x20simple\x20Go\x20code.\x0a</p>\x0a\x0a<p>\x0a\x20\x20In\x20this\x20tutorial\x20you'll\x20create\x20two\x20modules.\x20The\x20first\x20is\x20a\x20library\x20which\x20is\x0a\x20\x20intended\x20to\x20be\x20imported\x20by\x20other\x20libraries\x20or\x20applications.\x20The\x20second\x20is\x20a\x0a\x20\x20caller\x20application\x20which\x20will\x20use\x20the\x20first.\x0a</p>\x0a\x0a<p>\x0a\x20\x20This\x20tutorial's\x20sequence\x20includes\x20six\x20brief\x20topics\x20that\x20each\x20illustrate\x20a\x0a\x20\x20different\x20part\x20of\x20the\x20language.\x0a</p>\x0a\x0a<ol>\x0a\x20\x20<li>\x0a\x20\x20\x20\x20Create\x20a\x20module\x20--\x20Write\x20a\x20small\x20module\x20with\x20functions\x20you\x20can\x20call\x20from\x0a\x20\x20\x20\x20another\x20module.\x0a\x20\x20</li>\x0a\x20\x20<li>\x0a\x20\x20\x20\x20<a\x20href=\"call-module-code.html\">Call\x20your\x20code\x20from\x20another\x20module</a>\x20--\x0a\x20\x20\x20\x20Import\x20and\x20use\x20your\x20new\x20module.\x0a\x20\x20</li>\x0a\x20\x20<li>\x0a\x20\x20\x20\x20<a\x20href=\"handle-errors.html\">Return\x20and\x20handle\x20an\x20error</a>\x20--\x20Add\x20simple\x0a\x20\x20\x20\x20error\x20handling.\x0a\x20\x20</li>\x0a\x20\x20<li>\x0a\x20\x20\x20\x20<a\x20href=\"random-greeting.html\">Return\x20a\x20random\x20greeting</a>\x20--\x20Handle\x20data\x0a\x20\x20\x20\x20in\x20slices\x20(Go's\x20dynamically-sized\x20arrays).\x0a\x20\x20</li>\x0a\x20\x20<li>\x0a\x20\x20\x20\x20<a\x20href=\"greetings-multiple-people.html\"\x0a\x20\x20\x20\x20\x20\x20>Return\x20greetings\x20for\x20multiple\x20people</a\x0a\x20\x20\x20\x20>\x0a\x20\x20\x20\x20--\x20Store\x20key/value\x20pairs\x20in\x20a\x20map.\x0a\x20\x20</li>\x0a\x20\x20<li>\x0a\x20\x20\x20\x20<a\x20href=\"add-a-test.html\">Add\x20a\x20test</a>\x20--\x20Use\x20Go's\x20built-in\x20unit\x20testing\x0a\x20\x20\x20\x20features\x20to\x20test\x20your\x20code.\x0a\x20\x20</li>\x0a\x20\x20<li>\x0a\x20\x20\x20\x20<a\x20href=\"compile-install.html\">Compile\x20and\x20install\x20the\x20application</a>\x20--\x0a\x20\x20\x20\x20Compile\x20and\x20install\x20your\x20code\x20locally.\x0a\x20\x20</li>\x0a</ol>\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,\x20loops,\x20and\x20arrays.\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=\"start\">Start\x20a\x20module\x20that\x20others\x20can\x20use</h2>\x0a\x0a<p>\x0a\x20\x20Start\x20by\x20creating\x20a\x0a\x20\x20<a\x20href=\"https://golang.org/doc/code.html#Organization\">Go\x20module</a>.\x20In\x20a\x0a\x20\x20module,\x20you\x20collect\x20one\x20or\x20more\x20related\x20packages\x20for\x20a\x20discrete\x20and\x20useful\x20set\x0a\x20\x20of\x20functions.\x20For\x20example,\x20you\x20might\x20create\x20a\x20module\x20with\x20packages\x20that\x20have\x0a\x20\x20functions\x20for\x20doing\x20financial\x20analysis\x20so\x20that\x20others\x20writing\x20financial\x0a\x20\x20applications\x20can\x20use\x20your\x20work.\x0a</p>\x0a\x0a<p>\x0a\x20\x20Go\x20code\x20is\x20grouped\x20into\x20packages,\x20and\x20packages\x20are\x20grouped\x20into\x20modules.\x20Your\x0a\x20\x20package's\x20module\x20specifies\x20the\x20context\x20Go\x20needs\x20to\x20run\x20the\x20code,\x20including\x20the\x0a\x20\x20Go\x20version\x20the\x20code\x20is\x20written\x20for\x20and\x20the\x20set\x20of\x20other\x20modules\x20it\x20requires.\x0a</p>\x0a\x0a<p>\x0a\x20\x20As\x20you\x20add\x20or\x20improve\x20functionality\x20in\x20your\x20module,\x20you\x20publish\x20new\x20versions\x0a\x20\x20of\x20the\x20module.\x20Developers\x20writing\x20code\x20that\x20calls\x20functions\x20in\x20your\x20module\x20can\x0a\x20\x20import\x20the\x20module's\x20updated\x20packages\x20and\x20test\x20with\x20the\x20new\x20version\x20before\x0a\x20\x20putting\x20it\x20into\x20production\x20use.\x0a</p>\x0a\x0a<ol>\x0a\x20\x20<li>\x0a\x20\x20\x20\x20Open\x20a\x20command\x20prompt\x20and\x20<code>cd</code>\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\x20<code>greetings</code>\x20directory\x20for\x20your\x20Go\x20module\x20source\x20code.\x0a\x20\x20\x20\x20This\x20is\x20where\x20you'll\x20write\x20your\x20module\x20code.\x0a\x0a\x20\x20\x20\x20<p>\x0a\x20\x20\x20\x20\x20\x20For\x20example,\x20from\x20your\x20home\x20directory\x20use\x20the\x20following\x20commands:\x0a\x20\x20\x20\x20</p>\x0a\x0a\x20\x20\x20\x20<pre>\x0amkdir\x20greetings\x0acd\x20greetings\x0a</pre\x0a\x20\x20\x20\x20>\x0a\x20\x20</li>\x0a\x0a\x20\x20<li>\x0a\x20\x20\x20\x20Start\x20your\x20module\x20using\x20the\x0a\x20\x20\x20\x20<a\x0a\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><code>go\x20mod\x20init</code>\x20command</a\x0a\x20\x20\x20\x20>\x0a\x20\x20\x20\x20to\x20create\x20a\x20go.mod\x20file.\x0a\x0a\x20\x20\x20\x20<p>\x0a\x20\x20\x20\x20\x20\x20Run\x20the\x20<code>go\x20mod\x20init</code>\x20command,\x20giving\x20it\x20the\x20path\x20of\x20the\x20module\x0a\x20\x20\x20\x20\x20\x20your\x20code\x20will\x20be\x20in.\x20Here,\x20use\x20<code>example.com/greetings</code>\x20for\x20the\x0a\x20\x20\x20\x20\x20\x20module\x20path\x20--\x20in\x20production\x20code,\x20this\x20would\x20be\x20the\x20URL\x20from\x20which\x20your\x0a\x20\x20\x20\x20\x20\x20module\x20can\x20be\x20downloaded.\x0a\x20\x20\x20\x20</p>\x0a\x0a\x20\x20\x20\x20<pre>\x0a$\x20go\x20mod\x20init\x20example.com/greetings\x0ago:\x20creating\x20new\x20go.mod:\x20module\x20example.com/greetings\x0a</pre\x0a\x20\x20\x20\x20>\x0a\x0a\x20\x20\x20\x20<p>\x0a\x20\x20\x20\x20\x20\x20The\x20<code>go\x20mod\x20init</code>\x20command\x20creates\x20a\x20go.mod\x20file\x20that\x20identifies\x0a\x20\x20\x20\x20\x20\x20your\x20code\x20as\x20a\x20module\x20that\x20might\x20be\x20used\x20from\x20other\x20code.\x20The\x20file\x20you\x0a\x20\x20\x20\x20\x20\x20just\x20created\x20includes\x20only\x20the\x20name\x20of\x20your\x20module\x20and\x20the\x20Go\x20version\x20your\x0a\x20\x20\x20\x20\x20\x20code\x20supports.\x20But\x20as\x20you\x20add\x20dependencies\x20--\x20meaning\x20packages\x20from\x20other\x0a\x20\x20\x20\x20\x20\x20modules\x20--\x20the\x20go.mod\x20file\x20will\x20list\x20the\x20specific\x20module\x20versions\x20to\x20use.\x0a\x20\x20\x20\x20\x20\x20This\x20keeps\x20builds\x20reproducible\x20and\x20gives\x20you\x20direct\x20control\x20over\x20which\x0a\x20\x20\x20\x20\x20\x20module\x20versions\x20to\x20use.\x0a\x20\x20\x20\x20</p>\x0a\x20\x20</li>\x0a\x0a\x20\x20<li>\x0a\x20\x20\x20\x20In\x20your\x20text\x20editor,\x20create\x20a\x20file\x20in\x20which\x20to\x20write\x20your\x20code\x20and\x20call\x20it\x0a\x20\x20\x20\x20greetings.go.\x0a\x20\x20</li>\x0a\x0a\x20\x20<li>\x0a\x20\x20\x20\x20Paste\x20the\x20following\x20code\x20into\x20your\x20greetings.go\x20file\x20and\x20save\x20the\x20file.\x0a\x0a\x20\x20\x20\x20<pre>\x0apackage\x20greetings\x0a\x0aimport\x20\"fmt\"\x0a\x0a//\x20Hello\x20returns\x20a\x20greeting\x20for\x20the\x20named\x20person.\x0afunc\x20Hello(name\x20string)\x20string\x20{\x0a\x20\x20\x20\x20//\x20Return\x20a\x20greeting\x20that\x20embeds\x20the\x20name\x20in\x20a\x20message.\x0a\x20\x20\x20\x20message\x20:=\x20fmt.Sprintf(\"Hi,\x20%v.\x20Welcome!\",\x20name)\x0a\x20\x20\x20\x20return\x20message\x0a}\x0a</pre\x0a\x20\x20\x20\x20>\x0a\x0a\x20\x20\x20\x20<p>\x0a\x20\x20\x20\x20\x20\x20This\x20is\x20the\x20first\x20code\x20for\x20your\x20module.\x20It\x20returns\x20a\x20greeting\x20to\x20any\x0a\x20\x20\x20\x20\x20\x20caller\x20that\x20asks\x20for\x20one.\x20You'll\x20write\x20code\x20that\x20calls\x20this\x20function\x20in\x0a\x20\x20\x20\x20\x20\x20the\x20next\x20step.\x0a\x20\x20\x20\x20</p>\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\x20Declare\x20a\x20<code>greetings</code>\x20package\x20to\x20collect\x20related\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\x20Implement\x20a\x20<code>Hello</code>\x20function\x20to\x20return\x20the\x20greeting.\x0a\x20\x20\x20\x20\x20\x20\x20\x20<p>\x0a\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20This\x20function\x20takes\x20a\x20<code>name</code>\x20parameter\x20whose\x20type\x20is\x0a\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20<code>string</code>,\x20and\x20returns\x20a\x20<code>string</code>.\x20In\x20Go,\x20a\x0a\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20function\x20whose\x20name\x20starts\x20with\x20a\x20capital\x20letter\x20can\x20be\x20called\x20by\x20a\x0a\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20function\x20not\x20in\x20the\x20same\x20package.\x20This\x20is\x20known\x20in\x20Go\x20as\x20an\x0a\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20<a\x20href=\"https://tour.golang.org/basics/3\"><em>exported</em>\x20name</a>.\x0a\x20\x20\x20\x20\x20\x20\x20\x20</p>\x0a\x20\x20\x20\x20\x20\x20\x20\x20<img\x20src=\"images/function-syntax.png\"\x20width=\"300px\"\x20/>\x0a\x20\x20\x20\x20\x20\x20</li>\x0a\x0a\x20\x20\x20\x20\x20\x20<li>\x0a\x20\x20\x20\x20\x20\x20\x20\x20Declare\x20a\x20<code>message</code>\x20variable\x20to\x20hold\x20your\x20greeting.\x0a\x20\x20\x20\x20\x20\x20\x20\x20<p>\x0a\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20In\x20Go,\x20the\x20<code>:=</code>\x20operator\x20is\x20a\x20shortcut\x20for\x20declaring\x20and\x0a\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20initializing\x20a\x20variable\x20in\x20one\x20line\x20(Go\x20uses\x20the\x20value\x20on\x20the\x20right\x20to\x0a\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20determine\x20the\x20variable's\x20type).\x20Taking\x20the\x20long\x20way,\x20you\x20might\x20have\x0a\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20written\x20this\x20as:\x0a\x20\x20\x20\x20\x20\x20\x20\x20</p>\x0a\x20\x20\x20\x20\x20\x20\x20\x20<pre>\x0avar\x20message\x20string\x0amessage\x20=\x20fmt.Sprintf(\"Hi,\x20%v.\x20Welcome!\",\x20name)\x0a</pre\x0a\x20\x20\x20\x20\x20\x20\x20\x20>\x0a\x20\x20\x20\x20\x20\x20</li>\x0a\x0a\x20\x20\x20\x20\x20\x20<li>\x0a\x20\x20\x20\x20\x20\x20\x20\x20Use\x20the\x20<code>fmt</code>\x20package's\x20<code>Sprintf</code>\x20function\x20to\x0a\x20\x20\x20\x20\x20\x20\x20\x20create\x20a\x20greeting\x20message.\x20The\x20first\x20argument\x20is\x20a\x20format\x20string,\x20and\x0a\x20\x20\x20\x20\x20\x20\x20\x20<code>Sprintf</code>\x20substitutes\x20the\x20<code>name</code>\x20parameter's\x20value\x0a\x20\x20\x20\x20\x20\x20\x20\x20for\x20the\x20<code>%v</code>\x20format\x20verb.\x20Inserting\x20the\x20value\x20of\x20the\x0a\x20\x20\x20\x20\x20\x20\x20\x20<code>name</code>\x20parameter\x20completes\x20the\x20greeting\x20text.\x0a\x20\x20\x20\x20\x20\x20</li>\x0a\x20\x20\x20\x20\x20\x20<li>Return\x20the\x20formatted\x20greeting\x20text\x20to\x20the\x20caller.</li>\x0a\x20\x20\x20\x20</ul>\x0a\x20\x20</li>\x0a</ol>\x0a\x0a<p>\x0a\x20\x20In\x20the\x20<a\x20href=\"call-module-code.html\">next\x20step</a>,\x20you'll\x20call\x20this\x0a\x20\x20function\x20from\x20another\x20module.\x0a</p>\x0a\x0a<p\x20class=\"Navigation\">\x0a\x20\x20<a\x20class=\"Navigation-next\"\x20href=\"call-module-code.html\"\x0a\x20\x20\x20\x20>Call\x20your\x20code\x20from\x20another\x20module\x20></a\x0a\x20\x20>\x0a</p>\x0a",
"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",
