diff options
| author | Steve Traut <straut@google.com> | 2021-08-19 10:27:41 -0400 |
|---|---|---|
| committer | Steve Traut <straut@google.com> | 2021-09-08 14:57:14 +0000 |
| commit | 12eac51beafb23e225a5e486c056626386672c60 (patch) | |
| tree | 2acafc1d23013ea6efed7d5b4260a9a360638c1d /_content/doc/tutorial/create-module.html | |
| parent | 06d6b9d29b8244fe90ea8518bd521344fd4d87e8 (diff) | |
| download | go-x-website-12eac51beafb23e225a5e486c056626386672c60.tar.xz | |
_content/doc: module naming best practices
This adds new content with best practices for the module path. It also
revises existing content to use the best practice.
This change includes:
* A new "Naming a module" section in "Managing dependencies" describing
naming best practices and reserved terms for module paths.
* Changing module path prefix from "example.com/*" to "example/*"
where the content seems aimed specifically at new users. This is
designed to reduce confusion for those who wonder if a domain name
is required in the local, simple context.
* Links to the "Naming a module" section so that new users can follow up
from the simple case to learn about best practices.
Change-Id: I07eac1f805ce506a486d3c0e7b54539554e3c30b
Reviewed-on: https://go-review.googlesource.com/c/website/+/344469
Trust: Steve Traut <straut@google.com>
Trust: Bryan C. Mills <bcmills@google.com>
Reviewed-by: Bryan C. Mills <bcmills@google.com>
Run-TryBot: Bryan C. Mills <bcmills@google.com>
TryBot-Result: Go Bot <gobot@golang.org>
Diffstat (limited to '_content/doc/tutorial/create-module.html')
| -rw-r--r-- | _content/doc/tutorial/create-module.html | 6 |
1 files changed, 6 insertions, 0 deletions
diff --git a/_content/doc/tutorial/create-module.html b/_content/doc/tutorial/create-module.html index e9df3367..d187f4f9 100644 --- a/_content/doc/tutorial/create-module.html +++ b/_content/doc/tutorial/create-module.html @@ -152,6 +152,12 @@ cd greetings Go tools. That would be your code's repository. </p> + <p> + For more on naming your module with a module path, see + <a href="/doc/modules/managing-dependencies#naming_module">Managing + dependencies</a>. + </p> + <pre> $ go mod init example.com/greetings go: creating new go.mod: module example.com/greetings |
