website/tour
Dmitri Shuralyov 577a9fdbc0 website: update deploying sections in README files
Use the README in cmd/golangorg directory as the canonical location
for documenting the deployment process for websites served by that
command. The top-level README now redirects to it, just like the
README in tour directory.

Add more context on how the website uses tests to ensure that deploys
can be done safely.

While here, also shorten various URLs to use the new go.dev domain.

For golang/go#36707.
Updates golang/go#39687.

Change-Id: If5cf7a74b19830540b29612de37286c5f14244a1
Reviewed-on: https://go-review.googlesource.com/c/website/+/367994
Reviewed-by: Russ Cox <rsc@golang.org>
Reviewed-by: Katie Hockman <katie@golang.org>
Trust: Katie Hockman <katie@golang.org>
Trust: Dmitri Shuralyov <dmitshur@golang.org>
2021-12-06 17:29:19 +00:00
..
tools [x/tour] tour: map old urls to new ones where possible 2015-07-28 15:40:58 +00:00
.gcloudignore [x/tour] tour: deploy with App Engine Standard on Go 1.11 2019-03-07 18:39:40 +00:00
README.md website: update deploying sections in README files 2021-12-06 17:29:19 +00:00
TODO [x/tour] go-tour: adding items to TODO 2014-08-07 15:36:58 -07:00
TRANSLATE tour: serve from cmd/golangorg as go.dev/tour 2021-11-22 16:43:07 +00:00
main.go tour: serve from cmd/golangorg as go.dev/tour 2021-11-22 16:43:07 +00:00

README.md

Go Tour

Go Reference

A Tour of Go is an introduction to the Go programming language. Visit https://go.dev/tour/ to start the tour.

Download/Install

To install the tour from source, first install Go and then run:

go install golang.org/x/website/tour@latest

This will place a tour binary in your GOPATH's bin directory. The tour program can be run offline.

Send Patches

This repository uses Gerrit for code changes. To learn how to submit changes to this repository, see https://go.dev/doc/contribute.

To run the tour server locally:

go run .

Your browser should now open. If not, please visit http://localhost:3999/.

Report Issues

The issue tracker for the tour's code is located at https://github.com/golang/go/issues. Prefix your issue with "x/website/tour:" in the subject line, so it is easy to find.

Issues with the tour's content itself should be reported in the issue tracker at https://github.com/golang/tour/issues.

Deploying

Each time a CL is reviewed and submitted, the tour is automatically deployed to App Engine as part of the main go.dev web site. See ../cmd/golangorg/README.md for details.

License

Unless otherwise noted, the go-tour source files are distributed under the BSD-style license found in the LICENSE file.