Now that search is turned off, all the index code can be deleted.
For golang/go#41102.
Change-Id: Idb82f2b80cadb5a2d209b5e5995d38c35ffaf8db
Reviewed-on: https://go-review.googlesource.com/c/website/+/293412
Trust: Russ Cox <rsc@golang.org>
Reviewed-by: Dmitri Shuralyov <dmitshur@golang.org>
Copied from Go commit 094048b93845c08e0f2db8639764f9564e64835b,
deleted there in CL 295209.
Include the fix from CL 292471: remove a resolved TODO comment.
Updates golang/go#40700.
Change-Id: I0c7a9b3855d4205783ca631aaeb64b6b52dde0c5
Reviewed-on: https://go-review.googlesource.com/c/website/+/295249
Trust: Dmitri Shuralyov <dmitshur@golang.org>
Reviewed-by: Alexander Rakoczy <alex@golang.org>
Reviewed-by: Carlos Amedee <carlos@golang.org>
Change-Id: Ia8a55ac05ab2209f6076e4328bd5f53d67df8b53
Reviewed-on: https://go-review.googlesource.com/c/website/+/293169
Trust: Jay Conrod <jayconrod@google.com>
Trust: Bryan C. Mills <bcmills@google.com>
Run-TryBot: Jay Conrod <jayconrod@google.com>
TryBot-Result: Go Bot <gobot@golang.org>
Reviewed-by: Dmitri Shuralyov <dmitshur@golang.org>
The search feature is not used much and does not give terribly useful answers.
It accounts for under 2% of golang.org traffic and about one real query per minute.
Looking through a log of 1,592 search queries over a 28-hour period last week,
almost all of them would have found better answers using Google or pkg.go.dev.
Just a few examples of queries for which we had no good answers:
- 1.16
- 1.16beta
- GOPATH
- k8s.io/api/settings/v1alpha1
- language and capacity
- linux installation
- logical operators
- mocking struct
- naming convention
- remove element from slice
- sirupsen/logrus
- string template
- struct field tag
- tutorial
- update go
- using go modules
- visual studio code
Removing the search box on the main site will stop acting as though it gives
useful information for queries like these. Then hopefully people will find their
way to Google or pkg.go.dev instead.
Fixes#44357.
Change-Id: I400157e478a9faaf35c3fdb60380336ee0b135a3
Reviewed-on: https://go-review.googlesource.com/c/website/+/292590
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 was added in CL 207263 to isolate these from the
main repo. That's not a concern anymore, and it's keeping
them out of the website module and therefore out of the embed.
Delete the go.mod to put them back.
Fixesgolang/go#44314.
Change-Id: I36c20607d6132ad089ddae8150abe220eb90d3fd
Reviewed-on: https://go-review.googlesource.com/c/website/+/293410
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>
Fix typo in the description of the sample replace directive.
Change-Id: Ifce15609e096253c07137bf6727568bde58982c3
GitHub-Last-Rev: 54973c41cf
GitHub-Pull-Request: golang/website#38
Reviewed-on: https://go-review.googlesource.com/c/website/+/292991
Reviewed-by: Steve Traut <straut@google.com>
Trust: Dmitri Shuralyov <dmitshur@golang.org>
Directory is mispelled as "diretory" and version is mispelled as "verison".
Change-Id: Id990c87e259761e84595206b19d779856ce4b344
GitHub-Last-Rev: 10b74268de
GitHub-Pull-Request: golang/website#37
Reviewed-on: https://go-review.googlesource.com/c/website/+/292989
Trust: Ian Lance Taylor <iant@golang.org>
Trust: Dmitri Shuralyov <dmitshur@golang.org>
Reviewed-by: Dmitri Shuralyov <dmitshur@golang.org>
Run-TryBot: Dmitri Shuralyov <dmitshur@golang.org>
TryBot-Result: Go Bot <gobot@golang.org>
For golang/go#41730
Change-Id: Ie5437ad57be79e42a2a7cd2e89264dbba5285941
Reviewed-on: https://go-review.googlesource.com/c/website/+/290992
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
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>
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>
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>
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>
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>
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>
From CL 273426.
Change-Id: I8bd44fe938e56aeb4eb8305d87f9e67f99b480e0
Reviewed-on: https://go-review.googlesource.com/c/website/+/276355
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#33637Fixesgolang/go#41267
Change-Id: Ic7928c05ef200b574afc15acdbabdc6ab2d5e30d
Reviewed-on: https://go-review.googlesource.com/c/website/+/276354
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: I689ddec1dbfc2f4c4c0d5a6b4503f430d648f6e5
Reviewed-on: https://go-review.googlesource.com/c/website/+/276353
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>
It's a less formal synonym for "main module". "Current module" is more
intuitive when running commands which have a clear working directory,
but "main module" may be used in more general contexts.
For golang/go#33637
Change-Id: Ic41583de8deb7ad2e852a55c854cfb0fc6b86483
Reviewed-on: https://go-review.googlesource.com/c/website/+/276352
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>