Modules
Russ Cox edited this page 2023-12-14 22:14:45 -05:00

Page revisions

380 Commits

Author SHA1 Message Date
thepudds
738d95c3fb delete sentence in 'Version selection' example to make it a bit shorter 2018-08-29 08:37:13 -04:00
thepudds
bacacf017d one more tweak to 'Version selection' section 2018-08-29 00:39:38 -04:00
thepudds
2b5afbd3fb mention explicitly that `go.mod` provides enough information for reproducible builds without `go.sum` being a lock file. (Some people think of `go.sum` as a lock file). 2018-08-29 00:35:43 -04:00
thepudds
12e9b8faa5 eliminate second use of 'introduce' in sentence in 'Version Selection' section 2018-08-29 00:20:21 -04:00
thepudds
7806bc7bdc slightly expand minimal version selection example again 2018-08-29 00:16:41 -04:00
thepudds
def8ca7a63 tweak intro 2018-08-28 17:26:39 -04:00
thepudds
cc84ca2ac9 slightly expand intro 2018-08-28 17:24:14 -04:00
thepudds
3e96807c38 one more tweak to wording in 'minimal version selection' example 2018-08-28 16:01:45 -04:00
thepudds
def87cb213 tweak the small 'minimal version selection' example one more time 2018-08-28 15:57:41 -04:00
thepudds
40dae3efe9 slightly shrink the new FAQ 2018-08-28 15:16:21 -04:00
thepudds
c0b571cbe7 the just-added url to new FAQ had issue 2018-08-28 15:03:24 -04:00
thepudds
cb4e8b549f update MVS example, including more explicitly work in the phrase "100% reproducible builds"; also draw stronger contrast between `go mod tidy` vs. `go build`; move proxy discussion into FAQ (prior level of detail didn't really belong up front) 2018-08-28 15:01:45 -04:00
thepudds
038b77ea12 clarify FAQ on when old vs. new behavior kicks in; also add missing paren from prior edit 2018-08-28 12:20:18 -04:00
thepudds
b158533b5b flip order of explanation for why `go mod tidy` is useful, and provide a more targeted pointer to explanation how `go mod tidy` reflects all possible build tags/OS/architecture combinations 2018-08-28 12:15:26 -04:00
Baruch Sadogursky
4c8cef3877 JFrog Artifactory 2018-08-28 07:19:09 -06:00
Baruch Sadogursky
43df1131a5 Added JFrog Artifactory 2018-08-28 07:18:04 -06:00
thepudds
f43537c729 add word 'optional' to Project Athens parenthetical. some people think everyone will be required to run their on GOPROXY 2018-08-26 12:49:26 -04:00
thepudds
8ff454410e add a v2+ example to the first go.mod example; remove sentence about ability to quote module paths (given its usefulness is more a corner case that doesn't need to be covered so early in introductory material) 2018-08-26 12:45:52 -04:00
thepudds
7ce45c3b73 slightly shrink the CI bullet; slightly shrink recent history bullet 2018-08-26 12:41:13 -04:00
thepudds
5978cee39e slightly expand the proxy/Project Athens parenthetical. 2018-08-26 12:36:33 -04:00
thepudds
90d81be98d explicitly mention the `v` in required in semver tags; mention modules can consume non-modules and unversioned packages 2018-08-26 12:21:40 -04:00
thepudds
93bae8f136 shorten one of the FAQs slightly 2018-08-25 22:39:46 -04:00
thepudds
15f1244f1d let's not use the past tense with 'added' in our first sentence. (Modules are a journey!) 2018-08-25 22:01:50 -04:00
thepudds
49436e526b light update to reflect Go 1.11 was officially released 2018-08-25 22:00:24 -04:00
thepudds
586c5c0807 include quote to further explain why #24250 is not in 1.11. (People are continuing to express surprise about this). 2018-08-25 21:37:33 -04:00
thepudds
e24c771a52 tweak formatting for the FAQs I just added 2018-08-25 15:09:57 -04:00
thepudds
758e608d49 add 3 more FAQs on: why `go get example.com/cmd` fails with error `cannot find main module` when run outside of module; how to track tool dependencies of a specific module; and summarize the GO111MODULE/GOPATH behavior 2018-08-25 15:02:30 -04:00
thepudds
ff8f0f8297 mention `go get ...@master` as one way to obtain the latest commit 2018-08-25 13:07:59 -04:00
thepudds
23d2952d75 add additional pointer to semver in 'Semantic Import Versioning' section 2018-08-25 13:00:46 -04:00
thepudds
01c7434d49 expand the 'Semantic Import Versioning' section, including quote the old versioning advice from the FAQ, quote the import compatibility rule, attempt to tie them together 2018-08-25 10:49:21 -04:00
thepudds
656e835e1e simplify 'Semantic Import Versioning' section (and the pointer to the doc has more details) 2018-08-21 15:32:45 -04:00
thepudds
ca810be451 #26594 is now addressed, though not 100% clear exactly which released fixed it (rc1 vs. maybe requires rc2) 2018-08-19 10:34:08 -04:00
thepudds
6ae9d6f199 mention `go list -m all` to see versions of direct and indirect dependencies 2018-08-15 15:52:57 -04:00
thepudds
d8674ab1c8 expand `go test all` description slightly 2018-08-15 15:22:10 -04:00
thepudds
3d101f0792 small clean up to new go.sum section 2018-08-15 14:19:10 -04:00
thepudds
2999a1b654 small clarification to the CI section (those version identifiers are in theory the exact strings to use for RC1) 2018-08-15 13:22:54 -04:00
thepudds
d5e66eeaa4 small clarification on `go test all` 2018-08-15 13:20:27 -04:00
thepudds
c53293c317 use friendlier example module path for first time a module path shows up in the overall text 2018-08-15 13:05:09 -04:00
thepudds
e508c057ef minor formatting 2018-08-15 12:57:00 -04:00
thepudds
72779d82b0 include reference to pseudo-versions in module query introduction; use friendlier example modules for the intro `go.mod` shown and clean up related text 2018-08-15 12:48:53 -04:00
thepudds
56644ef83d the much older phrase of 'post v1 tags' is not really correct or at least open to misinterpretation -- 'v2+ tags' is clearer 2018-08-15 12:14:07 -04:00
thepudds
d0ef5ad484 mention option of a `v2.0.0` release on master along with the subsequent suggestion for a v1 branch (option outlined in official proposal FAQ); also provide an explicit pointer back to this v2+ discussion from the 'Releasing a module' section; adjust the older "still in flux" comment regarding v2+ modules 2018-08-15 12:07:14 -04:00
thepudds
aa43ea412e in 'Semantic import versioning' concepts section: include more explicit pointer to semantic import version section of tip documentation; mention the actual older versions 1.9.7 and 1.10.3 that now have minimal module awareness; mention that the '/v2' subdirectory approach allows for compatibility with even older Go versions and make the description a bit more specific 2018-08-15 11:52:47 -04:00
thepudds
b98d7cfb9b add pointer to brief rationale on checking in go.sum (currently a *very* brief rationale in the form of tweet from FiloSottile) 2018-08-15 09:39:44 -04:00
thepudds
abb30ff4d8 add a recommendation to typically check in `go.sum` (e.g., see https://twitter.com/FiloSottile/status/1029404663358087173); also mention that `go.sum` is not a traditional lock file, which is a question that comes up somewhat frequently 2018-08-15 09:32:02 -04:00
thepudds
9bd627b31a provide better instructions and better pointer on using RC1 with CircleCI 2018-08-14 18:59:50 -04:00
thepudds
0cd38b59ee 1.11rc1 is now available as a known go release in gimme (install utility used by Travis), so update to say 1.11rc1 in CI bullet 2018-08-13 23:38:15 -04:00
thepudds
f6ee899d65 update link to rc1 2018-08-13 23:09:48 -04:00
thepudds
f1bba83b46 update for go1.11rc1 2018-08-13 22:48:59 -04:00
thepudds
8d39bc32d5 also remove a reference to the -module flag from a piece of the prose 2018-08-13 13:34:49 -04:00