]> Cypherpunks repositories - gostls13.git/commitdiff
doc/go1.14: note that module support is ready for production use
authorBryan C. Mills <bcmills@google.com>
Fri, 24 Jan 2020 15:26:24 +0000 (10:26 -0500)
committerBryan C. Mills <bcmills@google.com>
Mon, 27 Jan 2020 14:34:16 +0000 (14:34 +0000)
The public proxy and checksum database launched with Go 1.13 have been
running smoothly, pkg.go.dev is serving module-aware documentation,
and in 1.14 we have improved the vendoring workflow and finished
Subversion support to reach parity with GOPATH mode for users of those
features, updated documentation (including the “How to Write Go Code”
intro document) and published blog posts describing common modes of
usage, and improved the migration path for existing v2+ modules by
making version resolution less aggressive about "+incompatible" major
versions.

We (always) have more fit-and-finish work to do, but at this point we
believe that module mode will provide a better user experience than
GOPATH mode for most users, including in production use.

Change-Id: I897e0a43e3aebe4c90553c414337a46bfc9c2bef
Reviewed-on: https://go-review.googlesource.com/c/go/+/216317
Reviewed-by: Jay Conrod <jayconrod@google.com>
Reviewed-by: Katie Hockman <katie@golang.org>
Reviewed-by: Russ Cox <rsc@golang.org>
doc/go1.14.html

index 99d2550680470a9492d820c136e5e8b56ea6cca6..245b068ce821be61e2d9c313132c0581f8a774e6 100644 (file)
@@ -24,6 +24,20 @@ Do not send CLs removing the interior tags from such phrases.
   </strong>
 </p>
 
+<p>
+Module support in the <code>go</code> command is now ready for production use,
+and we encourage all users to migrate to Go modules for dependency management.
+</p>
+
+<p>
+If you are unable to migrate due to a problem in the Go toolchain,
+please ensure that the problem has an
+<a href="https://golang.org/issue?q=is%3Aissue+is%3Aopen+label%3Amodules">open issue</a>
+filed. (If the issue is not on the <code>Go1.15</code> milestone, please let us
+know why it prevents you from migrating so that we can prioritize it
+appropriately.)
+</p>
+
 <h2 id="language">Changes to the language</h2>
 
 <p>