For golang/go#33637
For golang/go#40276
Change-Id: I25ef2024867194bd7dc2e70157fef9123498f49d
Reviewed-on: https://go-review.googlesource.com/c/website/+/285452
Trust: Jay Conrod <jayconrod@google.com>
Run-TryBot: Jay Conrod <jayconrod@google.com>
TryBot-Result: Go Bot <gobot@golang.org>
Reviewed-by: Bryan C. Mills <bcmills@google.com>
Change-Id: Ieb559df248ea4c7bdf23ef199e0520caf06a6de2
Reviewed-on: https://go-review.googlesource.com/c/website/+/292591
Trust: Alexander Rakoczy <alex@golang.org>
Run-TryBot: Alexander Rakoczy <alex@golang.org>
TryBot-Result: Go Bot <gobot@golang.org>
Reviewed-by: Dmitri Shuralyov <dmitshur@golang.org>
Reviewed-by: Carlos Amedee <carlos@golang.org>
For golang/go#40728
Change-Id: I9617d2ebd920d1a0de11c3d7ae9d99505f282b84
Reviewed-on: https://go-review.googlesource.com/c/website/+/285113
Trust: Jay Conrod <jayconrod@google.com>
Run-TryBot: Jay Conrod <jayconrod@google.com>
TryBot-Result: Go Bot <gobot@golang.org>
Reviewed-by: Bryan C. Mills <bcmills@google.com>
For golang/go#41330
Change-Id: Ib641601c4610a4ff554fcfe01b632b210fddd5ca
Reviewed-on: https://go-review.googlesource.com/c/website/+/285112
Trust: Jay Conrod <jayconrod@google.com>
Run-TryBot: Jay Conrod <jayconrod@google.com>
TryBot-Result: Go Bot <gobot@golang.org>
Reviewed-by: Bryan C. Mills <bcmills@google.com>
At this point, we're planning to have a single version of this
document that describes functionality in the highest supported version
of Go and notes where that differs from lower versions.
Changes after this point describe functionality new in Go 1.16.
For golang/go#33637
Change-Id: I485287ad724deb367da07d149cc862b7aff74c30
Reviewed-on: https://go-review.googlesource.com/c/website/+/284812
Trust: Jay Conrod <jayconrod@google.com>
Run-TryBot: Jay Conrod <jayconrod@google.com>
TryBot-Result: Go Bot <gobot@golang.org>
Reviewed-by: Bryan C. Mills <bcmills@google.com>
Ported CL 291990 to this repo.
For golang/go#43651.
Change-Id: I3680b32ef7a53b3901e54d4d1dbf680231870490
Reviewed-on: https://go-review.googlesource.com/c/website/+/292290
Trust: Russ Cox <rsc@golang.org>
Run-TryBot: Russ Cox <rsc@golang.org>
TryBot-Result: Go Bot <gobot@golang.org>
Reviewed-by: Ian Lance Taylor <iant@golang.org>
Reviewed-by: Dmitri Shuralyov <dmitshur@golang.org>
These are all the docs that aren't tied to active work in the main repo
(basically all docs, except the spec, memory model, assembler manual,
and in-progress release notes).
Copied from Go ff0e93ea3, deleted there in CL 291711.
Change-Id: Ia269abfc0fa207c036bb7b3c13e4167e80005d2c
Reviewed-on: https://go-review.googlesource.com/c/website/+/291693
Trust: Russ Cox <rsc@golang.org>
Run-TryBot: Russ Cox <rsc@golang.org>
TryBot-Result: Go Bot <gobot@golang.org>
Reviewed-by: Dmitri Shuralyov <dmitshur@golang.org>
The extra level of hierarchy here is unnecessary and confusing.
The directory is now _content so that any Go source files in our
docs are not considered by commands like "go mod tidy" and
"go test all".
Change-Id: Ib6d7cb12920193798ee825155a8f8b33f16e60d8
Reviewed-on: https://go-review.googlesource.com/c/website/+/291691
Trust: Russ Cox <rsc@golang.org>
Run-TryBot: Russ Cox <rsc@golang.org>
TryBot-Result: Go Bot <gobot@golang.org>
Reviewed-by: Dmitri Shuralyov <dmitshur@golang.org>
This lets us delete the generated static.go.
For golang/go#41102
Change-Id: Ie09f34a83f114592eec4ba2dd9263285169374ae
Reviewed-on: https://go-review.googlesource.com/c/website/+/291690
Trust: Russ Cox <rsc@golang.org>
Run-TryBot: Russ Cox <rsc@golang.org>
TryBot-Result: Go Bot <gobot@golang.org>
Reviewed-by: Dmitri Shuralyov <dmitshur@golang.org>
go get golang.org/x/tools@123adc
go mod tidy
This brings in an io/fs-to-vfs adapter and automatic
Markdown conversion in the godoc package, so that
the HTML does not need to be generated during makestatic.
Change-Id: I129ecbb4b7b16e130ddc0376bb85bccf12e74e22
Reviewed-on: https://go-review.googlesource.com/c/website/+/291689
TryBot-Result: Go Bot <gobot@golang.org>
Reviewed-by: Dmitri Shuralyov <dmitshur@golang.org>
Trust: Russ Cox <rsc@golang.org>
Run-TryBot: Russ Cox <rsc@golang.org>
We'd like to make it possible for people to run the web site with
go run ./cmd/golangorg -a
without having to worry about go generate or figuring out the -templates flag.
This is a step in that direction: it sets -templates correctly.
Even so, -templates is still incompatible with Markdown files.
Change-Id: I97afaafdbc66500c674c959383334bf2e5185316
Reviewed-on: https://go-review.googlesource.com/c/website/+/251377
Trust: Russ Cox <rsc@golang.org>
Trust: Dmitri Shuralyov <dmitshur@golang.org>
Run-TryBot: Russ Cox <rsc@golang.org>
TryBot-Result: Go Bot <gobot@golang.org>
Reviewed-by: Dmitri Shuralyov <dmitshur@golang.org>
Bring in the godoc fix made in CL 289089 with:
go get golang.org/x/tools/godoc@61406578735f11efca21e2be93800cf530d25ecb
go mod tidy
Fixesgolang/go#44178.
Updates golang/go#44081.
Change-Id: Icaee037626e93e6fc5939b163760ad11873a3f0b
Reviewed-on: https://go-review.googlesource.com/c/website/+/290609
TryBot-Result: Go Bot <gobot@golang.org>
Trust: Dmitri Shuralyov <dmitshur@golang.org>
Run-TryBot: Dmitri Shuralyov <dmitshur@golang.org>
Reviewed-by: Ian Lance Taylor <iant@golang.org>
Improve the guidance document to adapt to the Go 1.16.
Fixesgolang/go#43672
Change-Id: I443540591d032e05dbec951e2a4995f6dbc2bc77
Reviewed-on: https://go-review.googlesource.com/c/website/+/288277
Run-TryBot: Baokun Lee <bk@golangcn.org>
TryBot-Result: Go Bot <gobot@golang.org>
Reviewed-by: Dmitri Shuralyov <dmitshur@golang.org>
Trust: Baokun Lee <bk@golangcn.org>
Adding to each blog post a link to modules-related documentation.
Change-Id: I0f82692b528c2fe910466f36303573ce1ec98ccd
Reviewed-on: https://go-review.googlesource.com/c/blog/+/290389
Run-TryBot: Steve Traut <straut@google.com>
TryBot-Result: Go Bot <gobot@golang.org>
Reviewed-by: Dmitri Shuralyov <dmitshur@golang.org>
X-Blog-Commit: 8b806c840d8a6d724d75db0d72e7e706b2c8810f
Fix the link for the placeholder video like
CL 203825 did for the runtime selected one.
Fixesgolang/go#44037
Change-Id: Ic8b397c2c69f94d8a35e800515825380d06eaa4c
Reviewed-on: https://go-review.googlesource.com/c/website/+/288692
Run-TryBot: Dmitri Shuralyov <dmitshur@golang.org>
TryBot-Result: Go Bot <gobot@golang.org>
Reviewed-by: Dmitri Shuralyov <dmitshur@golang.org>
Reviewed-by: Alexander Rakoczy <alex@golang.org>
Trust: Alexander Rakoczy <alex@golang.org>
Trust: Carlos Amedee <carlos@golang.org>
This adds content that we can revise and enhance over time (unlike the
blog). The content has the following characteristics:
- It attempts to be task-oriented, focusing on the things users
will likely want to do.
- It includes content for two separate sets of user tasks: those
for developing modules and those for consuming them (managing the
dependencies).
- As article content, it can be updated and augmented over time based
on feature changes and user needs.
This change includes:
- A topic that includes help for dependency management tasks
(modules/managing-dependencies.md).
- Five topics for those intending to build and publish modules
for others to use.
- Developing and publishing modules (modules/developing.md) --
An overview.
- Module release and versioning workflow
(modules/release-workflow.md) -- Describes the high-level
steps in that workflow.
- Managing module source (modules/managing-source.md) --
Conventions and recommendations for sourcing modules to
publish.
- Developing a major version update (modules/major-version.md) --
Specifics about source for a major version update.
- Publishing a module (modules/publishing.md) -- Steps to
publish a module.
- A topic on module version numbering (modules/version-numbers.md).
- A topic with quick-reference information on the contents of a
go.mod file (modules/gomod-ref.md).
- Supporting images.
- Changes to the main docs page to reflect the additions (docs.html).
- A new modules/ folder for content files. As we add more content,
a second level of folders will help the doc set scale while
helping SEO.
- CSS changes to improve tables in docs and keep param lists
(in the go.mod reference) from extending rightward past the rest
of the content.
**Note about changes to docs.html** I essentially rearranged the
page to make it better suited to accept links for additional
planned documentation. These changes are intended to make it
clearer where the content is coming from while creating a space
for content that will be added later.
Change-Id: I0aa7a3c67e0b03a81cd4963e766b5dc7b27d85b2
Reviewed-on: https://go-review.googlesource.com/c/website/+/284472
Run-TryBot: Steve Traut <straut@google.com>
TryBot-Result: Go Bot <gobot@golang.org>
Reviewed-by: Dmitri Shuralyov <dmitshur@golang.org>
Trust: Steve Traut <straut@google.com>
Trust: Dmitri Shuralyov <dmitshur@golang.org>
Fixesgolang/go#44019
Change-Id: Ib7798cfbfac76cf0107738c93de7ea7948a117df
Reviewed-on: https://go-review.googlesource.com/c/website/+/288293
Run-TryBot: Dmitri Shuralyov <dmitshur@golang.org>
TryBot-Result: Go Bot <gobot@golang.org>
Reviewed-by: Dmitri Shuralyov <dmitshur@golang.org>
Trust: Carlos Amedee <carlos@golang.org>
Trust: Dmitri Shuralyov <dmitshur@golang.org>
Moves the HaTS trigger to the install doc pages so
that surveys will prompt while file downloads are
in progress.
Change-Id: I9437909c96907740fa21a0176d86b6adfe45d574
Reviewed-on: https://go-review.googlesource.com/c/website/+/286775
Reviewed-by: Alexander Rakoczy <alex@golang.org>
Trust: Jamal Carvalho <jamal@golang.org>
Adds a script to trigger HaTS on the download page in an
effort to track developer happiness with the core Go
distribution. Uses the same bucketing and rate limiting
logic as go.dev and pkg.go.dev.
Change-Id: I73cdb4577eaf71a77f09b94965e12871296a6699
Reviewed-on: https://go-review.googlesource.com/c/website/+/286293
Trust: Jamal Carvalho <jamal@golang.org>
Run-TryBot: Jamal Carvalho <jamal@golang.org>
TryBot-Result: Go Bot <gobot@golang.org>
Reviewed-by: Julie Qiu <julie@golang.org>
For golang/go#33637
Change-Id: Iba37b9ea0024e5c07d14d57861b4705d29f59e44
Reviewed-on: https://go-review.googlesource.com/c/website/+/285432
Trust: Jay Conrod <jayconrod@google.com>
Run-TryBot: Jay Conrod <jayconrod@google.com>
TryBot-Result: Go Bot <gobot@golang.org>
Reviewed-by: Bryan C. Mills <bcmills@google.com>
For golang/go#33637
Change-Id: I7a50195148dbf28c0c8eb01f4cf93463fbb269e6
Reviewed-on: https://go-review.googlesource.com/c/website/+/284591
Trust: Jay Conrod <jayconrod@google.com>
Run-TryBot: Jay Conrod <jayconrod@google.com>
TryBot-Result: Go Bot <gobot@golang.org>
Reviewed-by: Bryan C. Mills <bcmills@google.com>
Links to "go.mod files" should use the anchor "#go-mod-file", not
"#go-mod-files".
The glossary definition for "go.mod file" should use the anchor
"#glos-go-mod-file", not "#glos-go.mod-file".
These problems were introduced in CL 248617, which avoided a problem
with our markdown renderer cutting off anchor characters after '.'.
Change-Id: Ifd60aadf3fa2775af858f2317650838fc0cd0fab
Reviewed-on: https://go-review.googlesource.com/c/website/+/284590
Trust: Jay Conrod <jayconrod@google.com>
Run-TryBot: Jay Conrod <jayconrod@google.com>
TryBot-Result: Go Bot <gobot@golang.org>
Reviewed-by: Bryan C. Mills <bcmills@google.com>
For golang/go#33637
Change-Id: Ia11c79a3923a333fe0b20b0ea18dcc63b294c338
Reviewed-on: https://go-review.googlesource.com/c/website/+/284589
Trust: Jay Conrod <jayconrod@google.com>
Run-TryBot: Jay Conrod <jayconrod@google.com>
TryBot-Result: Go Bot <gobot@golang.org>
Reviewed-by: Bryan C. Mills <bcmills@google.com>
For golang/go#33637
Change-Id: Idb7006881b75394f2ffbfb6861fc8e54f19888ed
Reviewed-on: https://go-review.googlesource.com/c/website/+/284588
Trust: Jay Conrod <jayconrod@google.com>
Run-TryBot: Jay Conrod <jayconrod@google.com>
TryBot-Result: Go Bot <gobot@golang.org>
Reviewed-by: Bryan C. Mills <bcmills@google.com>
Change-Id: I1bbd0808fc43479a9fd84cc8e61dd8163aec96cf
Reviewed-on: https://go-review.googlesource.com/c/website/+/284872
Trust: Roland Shoemaker <roland@golang.org>
Run-TryBot: Roland Shoemaker <roland@golang.org>
TryBot-Result: Go Bot <gobot@golang.org>
Reviewed-by: Dmitri Shuralyov <dmitshur@golang.org>
Right now https://blog.golang.org/playground looks like:
Inside the Go Playground
Andrew Gerrand and _NOTE: This article does not describe the current version of the Go Playground._
12 December 2013
The note is not an author.
(The blog program prints a warning about this mistake on startup,
without this CL.)
Change-Id: I2ea605e2f069f4e9c8fb76de1c32ef04d3f85a5d
Reviewed-on: https://go-review.googlesource.com/c/blog/+/284833
Trust: Russ Cox <rsc@golang.org>
Run-TryBot: Russ Cox <rsc@golang.org>
Reviewed-by: Russ Cox <rsc@golang.org>
X-Blog-Commit: 73406574fd69fb5129b350eba3e8d41710f25751
Go packages are implicitly made of all the files in a directory,
filtered by build tags. This is a core mechanic of using Go and of
contributing to Go projects. It's also different from many other
languages, including C and Rust, where code in different compilation
units can coexist in the same directory.
The only exception is when Go files are specified on the command line,
in which case a synthetic command-line-arguments package is composed
from them, ignoring build tags.
I don't think it helps beginners to expose them to this exception which
they would otherwise probably never make any use of.
This CL was motivated by hearing of a beginner being confused trying to
contribute to an existing project, because they were trying to "go run"
an individual file, which was failing with a wall of error because of
all the missing symbols from the other files in the package.
Change-Id: Iec0ef73df1c5ada2299d059dd468dc2095c367a8
Reviewed-on: https://go-review.googlesource.com/c/website/+/283635
Trust: Filippo Valsorda <filippo@golang.org>
Reviewed-by: Steve Traut <straut@google.com>
Change-Id: I15acbe500ee05b3b87fa1cfb7eb7316c12cd3170
Reviewed-on: https://go-review.googlesource.com/c/blog/+/283292
Trust: Ian Lance Taylor <iant@golang.org>
Reviewed-by: Ian Lance Taylor <iant@golang.org>
X-Blog-Commit: 8f54d84632586578766250e121ce8cea34b30e2c
Change-Id: I0b69f26ac60ddc2509d2e15cca091f7fa949bf62
Reviewed-on: https://go-review.googlesource.com/c/blog/+/283272
Trust: Ian Lance Taylor <iant@golang.org>
Reviewed-by: Ian Lance Taylor <iant@golang.org>
X-Blog-Commit: 1264f4e07dcc97db682e2bc35cbc2adaa09a7c30
Go 1.16 will no longer accept "+" as a character in a module or import
path. Amend the module docs to reflect that change.
Fixesgolang/go#31376
For golang/go#43052
Change-Id: Ie0b58888cf5023c69f112dcc32137fc69af6c659
Reviewed-on: https://go-review.googlesource.com/c/website/+/282512
Trust: Michael Matloob <matloob@golang.org>
Run-TryBot: Michael Matloob <matloob@golang.org>
TryBot-Result: Go Bot <gobot@golang.org>
Reviewed-by: Jay Conrod <jayconrod@google.com>
Reviewed-by: Bryan C. Mills <bcmills@google.com>
The aforementioned bug has been resolved in https://golang.org/cl/183991.
Removing it from the blog content reduces cognitive overhead for readers.
Change-Id: I19b944599d97895217e3178b31edf6a25c4c1fdc
GitHub-Last-Rev: b7ec54580b8d1cd9c37d261bb92d95d955696149
GitHub-Pull-Request: golang/blog#48
Reviewed-on: https://go-review.googlesource.com/c/blog/+/277612
Reviewed-by: Bryan C. Mills <bcmills@google.com>
X-Blog-Commit: 4a950b243d00816dd0bbe7f3ccfd2f2c803666d4
Change the redirects to pkg.go.dev from godoc.org
Change-Id: Iecb1f6b16881bedaa47d65427b75b90baa2ae02a
Reviewed-on: https://go-review.googlesource.com/c/website/+/282292
Trust: Jonathan Amsterdam <jba@google.com>
Run-TryBot: Jonathan Amsterdam <jba@google.com>
TryBot-Result: Go Bot <gobot@golang.org>
Reviewed-by: Julie Qiu <julie@golang.org>
From perspective of someone who may not or may have an experience on
having race conditions, the line number "15" a little bit off because it
does not have any reference to variable `t`.
Especially when the next paragraph said "The race detector shows the
problem: an unsynchronized read and write of the variable t".
This changes not only fix the line number "15", but also make it
consistent with actual output (although its run on Go tip not Go 1.1),
----
% go run -race race.go
950.434733ms
==================
WARNING: DATA RACE
Read at 0x00c00013e018 by goroutine 8:
main.main.func1()
race.go:14 +0x126
Previous write at 0x00c00013e018 by main goroutine:
main.main()
race.go:12 +0x194
Goroutine 8 (running) created at:
time.goFunc()
.../share/go/src/time/sleep.go:169 +0x51
==================
1.037465812s
1.706961927s
...
----
the read conflict is on `func 001` (line number 16 on example) and write
conflict is on main (line number 14 on example).
Change-Id: I3b9a7880178845d8dc4dff38e197fc3eef407e58
Reviewed-on: https://go-review.googlesource.com/c/blog/+/280712
Reviewed-by: Andrew Gerrand <adg@golang.org>
X-Blog-Commit: c2ef14610cd691addcce190e8998df47bdb8c002
In the grpc.Dial option, the MaxDelay is set to time.Second, but in the
next example for a struct option the MaxDelay is set to time.Minute.
This changes make both examples use the same values for MaxDelay.
Change-Id: I0413b3ab88a1bcdc049827352b3662b98c88039d
Reviewed-on: https://go-review.googlesource.com/c/blog/+/277532
Reviewed-by: Jean de Klerk <deklerk@google.com>
Trust: Jean de Klerk <deklerk@google.com>
Run-TryBot: Jean de Klerk <deklerk@google.com>
X-Blog-Commit: 230e17776525076eeb5b3b5470ae0a43433f006f
Also remove spurious time in godoc.org-redirect.article.
It was copy-pasted from pkgsite-redesign.article, which needed it
because we posted two blog posts together, and the times
in 11years.article and pkgsite-redesign.article decided the
order in which they appeared on the blog.
But in general times are unnecessary, so remove the
one in godoc.org-redirect.article to avoid future copy-pasting.
Change-Id: I43e43baf911155d8f8e5fbc77110d4ede836518e
Reviewed-on: https://go-review.googlesource.com/c/blog/+/278933
Trust: Russ Cox <rsc@golang.org>
Run-TryBot: Russ Cox <rsc@golang.org>
Reviewed-by: Russ Cox <rsc@golang.org>
X-Blog-Commit: 429a8530ad5b2e44df336470d64300336d01a82d
We want the new darwin/arm64 installer and archive to be placed next
to the original darwin/amd64 files, not under "Other Ports". Also
highlight (make bold) the darwin/arm64 installer (but not archive).
The "pretty" version of the architecture will be displayed as "ARMv8",
and maybe should be made more macOS-specific in the future.
Updates golang/go#42756.
Change-Id: I5e95a3b93d30253d8fa291d153b3f96f49f9ab5d
Reviewed-on: https://go-review.googlesource.com/c/website/+/278787
Trust: Dmitri Shuralyov <dmitshur@golang.org>
Reviewed-by: Alexander Rakoczy <alex@golang.org>
Since there is no environment variable named `$GOOS_GOARCH` that means
the GOARCH should be prefixed with `$`.
Change-Id: Ifaabd9afadbaf8d2f9f8dcc637ffa87d5e3b2760
Reviewed-on: https://go-review.googlesource.com/c/website/+/277592
Reviewed-by: Dmitri Shuralyov <dmitshur@golang.org>
Reviewed-by: Ian Lance Taylor <iant@golang.org>
Jay Conrod
Dmitri Shuralyov
Alexander Rakoczy
Russ Cox
Baokun Lee
Sean Liao
Steve Traut
Carlos Amedee
Rebecca Stambler
Jamal Carvalho
Roland Shoemaker
Filippo Valsorda
Ian Lance Taylor
Michael Matloob
Marin
Jonathan Amsterdam
Krzysztof Dąbrowski
shulhan
Julie Qiu