They have been pre-announced¹.
Also update the release summary template to not point to the issue
tracker for future releases. The issue tracker is representative of
the final release content only for releases that have been completed.
¹ https://groups.google.com/d/msg/golang-announce/f2c5bqrGH_g/GnH6k56AAAAJ
Change-Id: I1b05a0d6ce3f3f05a441979f529d449a2f49465e
Reviewed-on: https://go-review.googlesource.com/c/website/+/242317
Run-TryBot: Dmitri Shuralyov <dmitshur@golang.org>
TryBot-Result: Gobot Gobot <gobot@golang.org>
Reviewed-by: Katie Hockman <katie@golang.org>
The /dl/{file} URLs have been supported for many years but not well
documented. Start using them on the /dl/ HTML page and document them,
so that it is clear that they can be reliably used in scripts or so.
This causes clients to have to make an extra HTTP request (which gets
redirected to the target location serving the file bytes), but compared
to the total work to download a Go file, this is negligible. Clients
that really want to skip the redirect can do so, but the trade-off is
that they need to update the URL if the CDN used for Go file downloads
happens to change. The /dl/{file} links are not expected to change for
Go 1.
Fixesgolang/go#38713.
Change-Id: I9df7d5b761baa6fa657c5dd2063c97b9b457367c
Reviewed-on: https://go-review.googlesource.com/c/website/+/238517
Run-TryBot: Dmitri Shuralyov <dmitshur@golang.org>
TryBot-Result: Gobot Gobot <gobot@golang.org>
Reviewed-by: Alexander Rakoczy <alex@golang.org>
Reviewed-by: Andrew Bonventre <andybons@golang.org>
Also covers file path and size constraints.
For golang/go#33637
Change-Id: Ib5e7dd3d8cfc8d38f3f0322003128209cb54811e
Reviewed-on: https://go-review.googlesource.com/c/website/+/236567
Run-TryBot: Jay Conrod <jayconrod@google.com>
TryBot-Result: Gobot Gobot <gobot@golang.org>
Reviewed-by: Bryan C. Mills <bcmills@google.com>
Reviewed-by: Michael Matloob <matloob@golang.org>
This CL adds alt tags for the gopher images in docs, for better
accessibility. The HTML spec indicates that purely decorative images
have empty alt tags, hence, the empty alt tags here.
Fixesgolang/go#39861
Change-Id: I5761e5c6c0005a6974e96a21263605fbfe8f27fc
Reviewed-on: https://go-review.googlesource.com/c/website/+/240257
Reviewed-by: Alexander Nohe <alex.nohe427@gmail.com>
Reviewed-by: Dmitri Shuralyov <dmitshur@golang.org>
This change re-enables the /s/ link shortener admin interface,
running as its own App Engine service on the go111 runtime,
which still supports the “login: admin” option in app.yaml.
+ The golangorg build constraint on the internal/memcache and
internal/short packages is removed to allow easy import
+ A new function, AdminHandler is introduced in the short package
to allow for registering the handler outside of it
+ Some page cleanup to leverage modern HTML and JS capabilities,
obviating the need for jQuery, which has been removed
+ Clients for Redis and Cloud Datastore have been updated to
the latest versions
Fixesgolang/go#29988
Change-Id: If6ca75e85e16a7d86bb5dafcf08b27d2dc36f530
Reviewed-on: https://go-review.googlesource.com/c/website/+/238545
Run-TryBot: Andrew Bonventre <andybons@golang.org>
TryBot-Result: Gobot Gobot <gobot@golang.org>
Reviewed-by: Dmitri Shuralyov <dmitshur@golang.org>
This change adds several new sections on the interaction between the
go command and version control systems.
"Module proxies" and "Version control systems" are now top-level
headings (h2) with several subsections.
Several new terms are added to the glossary. Text in the "Module
paths" introductory section is adjusted as well.
Updates golang/go#33637
Change-Id: I743d8f9fc611ac0196ca0839979237e73925a22e
Reviewed-on: https://go-review.googlesource.com/c/website/+/227637
Run-TryBot: Jay Conrod <jayconrod@google.com>
TryBot-Result: Gobot Gobot <gobot@golang.org>
Reviewed-by: Michael Matloob <matloob@golang.org>
The URL format has changed slightly, update it so that the Flexible
environment filter continues to be active.
Also, avoid printing directions at the end of the publish step in the
Makefile. Doing so creates overlap with the steps already listed in
the README and can be confusing. Instead, point back to the README.
Change-Id: If1d06735dff5744b81ad127e8621a35fa5bf167b
Reviewed-on: https://go-review.googlesource.com/c/website/+/234679
Reviewed-by: Chris Broadfoot <cbro@golang.org>
We are moving google-api-go-client to GitHub.
Change-Id: I1f231032f6881f0167dd742a0e46f725326ffca8
Reviewed-on: https://go-review.googlesource.com/c/website/+/234532
Reviewed-by: Dmitri Shuralyov <dmitshur@golang.org>
Run-TryBot: Dmitri Shuralyov <dmitshur@golang.org>
TryBot-Result: Gobot Gobot <gobot@golang.org>
Allow golang.org/x repos to opt-in to use pkg.go.dev for documentation.
The golang.org/x/pkgsite repository is the first one to use it.
Update to current golang.org/x/build version and regenerate:
go get golang.org/x/build/repos@92427f67eca1ac8f769c740f272196f368082630
go mod tidy
go generate ./...
Fixesgolang/go#39150.
For golang/go#36747.
For golang/go#36106.
Change-Id: Ia91725c12546c4e7467601d951144af3cb1e6863
Reviewed-on: https://go-review.googlesource.com/c/website/+/234678
Run-TryBot: Dmitri Shuralyov <dmitshur@golang.org>
TryBot-Result: Gobot Gobot <gobot@golang.org>
Reviewed-by: Julie Qiu <julie@golang.org>
There were a few files with different wording in the license header
than is present in the rest of the repository. Update these to say
“BSD-style” instead of “Apache 2.0”.
Change-Id: I24df0e69fbd18728dcf1aec8166c5a52407930f6
Reviewed-on: https://go-review.googlesource.com/c/website/+/231159
Reviewed-by: Alexander Rakoczy <alex@golang.org>
Reviewed-by: Dmitri Shuralyov <dmitshur@golang.org>
golang.org/s/key URL shortener supported only simple redirects
from key to a link. This change allows the short link to have
extra path elements, and computes the redirects by appending
the extra path elements to the resolved link. For example,
if golang.org/s/foo is configured to be resolved to example.com,
golang.org/s/foo/bar will result in a redirects to
example.com/bar.
Change-Id: I6aa9f4aab2d5a74c76fda446a29aae998fe48ad6
Reviewed-on: https://go-review.googlesource.com/c/website/+/227654
Run-TryBot: Andrew Bonventre <andybons@golang.org>
TryBot-Result: Gobot Gobot <gobot@golang.org>
Reviewed-by: Andrew Bonventre <andybons@golang.org>
This change builds on what was done in CL 229081, and uses the Go
release history data from internal/history package to generate the
list of major Go versions on the Go project page.
This way, this page doesn't need to be manually edited when major
Go releases are made.
For golang/go#38488.
For golang/go#29205.
For golang/go#29206.
Change-Id: Ie0b12707d828207173a54f0a1bc6a4ef69dcedef
Reviewed-on: https://go-review.googlesource.com/c/website/+/229483
Run-TryBot: Dmitri Shuralyov <dmitshur@golang.org>
TryBot-Result: Gobot Gobot <gobot@golang.org>
Reviewed-by: Alexander Rakoczy <alex@golang.org>
The Go Project page is copied from Go master as of 2020/04/24
(commit golang/go@ee8972cd12, CL 209679).
This page not closely tied to specific Go releases, and thus is better
suited to live in the x/website repo.
It will be modified in CL 229483 to use the release history data from
the internal/history package, rather than using hand-written HTML
which needs to be updated manually after each major Go release.
For golang/go#29205.
For golang/go#29206.
Change-Id: I6a6fa734fb3d873da59d67d796616fc53d684610
Reviewed-on: https://go-review.googlesource.com/c/website/+/229482
Reviewed-by: Alexander Rakoczy <alex@golang.org>
Make it more clear that this type represents a Go-specific version,
rather than a version that follows the Semantic Versioning 2.0.0
specification. The type already has Go-specific methods, for example
IsMajor reports true for "1.14" and IsMinor reports true for "1.14.1".
This is consistent with the terminology used by Go releases, but
very surprising if considered from the perspective of semver.
Document some differences of the Go-specific version convention
compared to semver, and describe the X, Y, Z fields in more detail.
This change makes it viable to add a String method to GoVer type
documented to print a Go-specific version string, which will be
useful in more places in CL 229483.
For golang/go#32450.
Change-Id: If7482fdb4a739ff5b89b7133402d94412057f590
Reviewed-on: https://go-review.googlesource.com/c/website/+/229481
Reviewed-by: Carlos Amedee <carlos@golang.org>
Previously, the release history page was a raw HTML file that was
manually edited whenever new Go releases were made. This change
converts release history entries into a structured format in the
new internal/history package, and generates release history entries
from that format.
For now, only Go 1.9 and newer releases are converted, but the
structured format is flexible enough to represent all releases
going back to the original Go 1 release.
Various English grammar rules and special cases are preserved,
so that the release history entries appear in a consistent way.
New release history entries need only to be added to the internal/
history package, making it so that English grammar rules and HTML
tags don't need to go through human code review for each release.
Future work may involve constructing that list from data already
available in the Go issue tracker.
This change makes minimal contributions to reducing the dependence
of x/website on the x/tools/godoc rendering engine for displaying
pages other than Go package documentation. The x/tools/godoc code
is in another module and does not provide flexibility desired for
the general purpose website needs of x/website.
Fixesgolang/go#38488.
For golang/go#37090.
For golang/go#29206.
Change-Id: I80864e4f218782e6e3b5fcd5a1d63f3699314c81
Reviewed-on: https://go-review.googlesource.com/c/website/+/229081
Run-TryBot: Dmitri Shuralyov <dmitshur@golang.org>
TryBot-Result: Gobot Gobot <gobot@golang.org>
Reviewed-by: Alexander Rakoczy <alex@golang.org>
All past release history entries have been written in raw HTML format
with a goal of keeping a consistent style and grammar. Apply fixes to
various minor inconsistencies that have made their way into the text.
This change is done in anticipation of the release history entries
being generated from a more structured source of data in CL 229081.
With these changes done, there will be no difference in displayed
HTML content after the transition.
For golang/go#38488.
Change-Id: Ifd19481d57a66d1ef30c5b92565618e1e9e450ce
Reviewed-on: https://go-review.googlesource.com/c/website/+/229080
Reviewed-by: Alexander Rakoczy <alex@golang.org>
There are no template features being used in either of these two files,
so convert them to regular non-template HTML files. Having template be
off has proven to be a safer default, and it uses less CPU.
For golang/go#37070.
For golang/go#37072.
For golang/go#37090.
Change-Id: Ib0de115e58c51a9660d648dbb8793fcaae9a7197
Reviewed-on: https://go-review.googlesource.com/c/website/+/229079
Reviewed-by: Alexander Rakoczy <alex@golang.org>
This package was not made internal in CL 218517 because it was
intended to be used by packages in golang.org/x/blog. However,
golang.org/x/blog ended up taking a different approach that did
not include using golang.org/x/website/markdown; see CL 222846.
Since there isn't a need for this package to be non-internal,
make it internal while it still has 0 known public importers,
to keep future maintenance costs down.
For golang/go#33637.
Change-Id: Ie31264fe14b5cc68d98adbf62d6b824f1df579fb
Reviewed-on: https://go-review.googlesource.com/c/website/+/228418
Run-TryBot: Dmitri Shuralyov <dmitshur@golang.org>
TryBot-Result: Gobot Gobot <gobot@golang.org>
Reviewed-by: Jay Conrod <jayconrod@google.com>
The PrimaryPort function is used in the dl page to split downloads
between first class and "Others". Since linux/arm64 is now a first
class port, it needs to be listed in the primary section.
Updates golang/go#35593Fixesgolang/go#38258
Change-Id: Ib3044b2feaad4b7b415d273fab014d83082c806f
Reviewed-on: https://go-review.googlesource.com/c/website/+/227597
Run-TryBot: Alberto Donizetti <alb.donizetti@gmail.com>
TryBot-Result: Gobot Gobot <gobot@golang.org>
Reviewed-by: Dmitri Shuralyov <dmitshur@golang.org>
This section describes communication with a proxy from the perspective
of the go command. It also gives several examples of requests and
responses using curl.
Updates golang/go#33637
Change-Id: Ic6b87aef55b667436be7b7a3a52a74b035ce8190
Reviewed-on: https://go-review.googlesource.com/c/website/+/225619
Run-TryBot: Jay Conrod <jayconrod@google.com>
TryBot-Result: Gobot Gobot <gobot@golang.org>
Reviewed-by: Michael Matloob <matloob@golang.org>
Reviewed-by: Bryan C. Mills <bcmills@google.com>
Added "Vendoring" and "go mod vendor". There is a fair amount of
overlap between the two. "Vendoring" is intended to describe the
concept of vendoring and how to enable it. "go mod vendor" is intended
to describe the command.
Updates golang/go#33637
Change-Id: I6d63b5a3dfcd477d2fcd4b0ea9dca7d6da956888
Reviewed-on: https://go-review.googlesource.com/c/website/+/224398
Run-TryBot: Jay Conrod <jayconrod@google.com>
TryBot-Result: Gobot Gobot <gobot@golang.org>
Reviewed-by: Bryan C. Mills <bcmills@google.com>
When generating an index, point the GOPATH environment variable to
an empty directory. Setting it to the empty string doesn't work as
of Go 1.8, where a default GOPATH value was added¹.
¹ https://golang.org/doc/go1.8#gopath
Change-Id: I9adfa60e8aa9c6931e3752b24720ec6e77932c9a
Reviewed-on: https://go-review.googlesource.com/c/website/+/221105
Reviewed-by: Alexander Rakoczy <alex@golang.org>
Run-TryBot: Alexander Rakoczy <alex@golang.org>
TryBot-Result: Gobot Gobot <gobot@golang.org>
The default suffix length is 2 letters, which can cause split files to
have suffixes such as .cc, .go, and so on. Files with those suffixes
are misinterpreted to be source code files, and prevent the golangorg
command from building successfully.
Avoid this problem by using a suffix of length 8.
Use a single space to separate flags and values, for consistency.
Change-Id: I5120286a6f56091db8e46e6a74ca2eb98994de60
Reviewed-on: https://go-review.googlesource.com/c/website/+/220997
Reviewed-by: Alexander Rakoczy <alex@golang.org>
Run-TryBot: Alexander Rakoczy <alex@golang.org>
TryBot-Result: Gobot Gobot <gobot@golang.org>
Added the Go 1.14 entry in the releases page.
Updated the GO_REF value in the deployment Makefile to
use the release-branch.go1.14 branch.
Change-Id: Ic66da008fa262ba642a2dbff775bee0ee70c1bf7
Reviewed-on: https://go-review.googlesource.com/c/website/+/220899
Reviewed-by: Alexander Rakoczy <alex@golang.org>
Reviewed-by: Dmitri Shuralyov <dmitshur@golang.org>
Run-TryBot: Alexander Rakoczy <alex@golang.org>
TryBot-Result: Gobot Gobot <gobot@golang.org>
This change prevents ./cmd/golangorg and other binaries that depend on
./content/static from transitively importing ./markdown. At this time,
./markdown is only needed for code generation (via go generate) and
for testing. It does not need to be linked into ./cmd/golangorg.
x/blog imports ./content/static. The transitive import of
github.com/yuin/goldmark causes Go 1.12 builders to fail because they
run in GOPATH mode, and they forbid dependencies outside the
golang.org/x repos.
Fixesgolang/go#37337
Change-Id: I938c06cdea66d6e08ac27d28f089026b42db9062
Reviewed-on: https://go-review.googlesource.com/c/website/+/220358
Run-TryBot: Jay Conrod <jayconrod@google.com>
TryBot-Result: Gobot Gobot <gobot@golang.org>
Reviewed-by: Dmitri Shuralyov <dmitshur@golang.org>
The HTML5 spec states that while some closing tags can be omitted,
<div> elements are not one of them. They must all include a closing
tag.
Fixesgolang/go#37075
Change-Id: I30f8cf2ec9e4b7b626f4954bb64055c5c7462ebd
Reviewed-on: https://go-review.googlesource.com/c/website/+/219507
Run-TryBot: Andrew Bonventre <andybons@golang.org>
TryBot-Result: Gobot Gobot <gobot@golang.org>
Reviewed-by: Andrew Bonventre <andybons@golang.org>
The tables in the GOPROXY protocol and Checksum database sections
are as wide as the window without styling.
This change adds a "ModProtocol" class for table elements (which these
two tables now use). The table has the same maximum width as
paragraphs, and cells within the table have thin border and consistent
padding.
Updates golang/go#33637
Change-Id: I33c9b815f45edc0202dfd429fd816389e2c62eb6
Reviewed-on: https://go-review.googlesource.com/c/website/+/218518
Run-TryBot: Jay Conrod <jayconrod@google.com>
TryBot-Result: Gobot Gobot <gobot@golang.org>
Reviewed-by: Andrew Bonventre <andybons@golang.org>
Using github.com/yuin/goldmark for Markdown rendering. Rendering only
happens when ./content/static is generated. ./cmd/golangorg does not
need to render anything on request.
Updates golang/go#33637
Change-Id: I68c80b1ed6543f0985848c6e5a58a07da05c972d
Reviewed-on: https://go-review.googlesource.com/c/website/+/218517
Reviewed-by: Dmitri Shuralyov <dmitshur@golang.org>
Dmitri Shuralyov
Jay Conrod
Alexander Nohe
Andrew Bonventre
Cody Oss
Agniva De Sarker
Chris Broadfoot
Hana (Hyang-Ah) Kim
Alberto Donizetti
Carlos Amedee
Bradford Lamson-Scribner