The Go Blog

Clone this repo:

Branches

  1. 72903b6 blog: add analytics HTML and deploy instructions by Dmitri Shuralyov · 2 weeks ago master
  2. e5b7b5c content: update store.article by Andrew Bonventre · 2 weeks ago
  3. 5dff4ce content: add Publishing Go Modules article by Tyler Bui-Palsulich · 3 weeks ago
  4. e69ff39 content/go-maps-in-action: remove line about random iteration order by Andrew Bonventre · 3 weeks ago
  5. 8c44769 all: upgrade dependency on x/website by Bryan C. Mills · 6 weeks ago

Go Blog

This repository holds the Go Blog server code and content.

Download/Install

The easiest way to install is to run go get -u golang.org/x/blog. You can also manually git clone the repository to $GOPATH/src/golang.org/x/blog.

Running Locally

To run the blog server locally:

go build && ./blog -reload

and then visit http://localhost:8080/ in your browser.

Contributing

Articles are written in the x/tools/present format. Articles on the blog should have broad interest to the Go community, and are mainly written by Go contributors. We encourage you to share your experiences using Go on your own website, and to share them with the Go community. Hugo is a static site server written in Go that makes it easy to write and share your stories.

Report Issues / Send Patches

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

The main issue tracker for the blog is located at https://github.com/golang/go/issues. Prefix your issue with “x/blog:” in the subject line, so it is easy to find.

Deploying

  1. To deploy blog.golang.org, run:

    GO111MODULE=on gcloud --project=golang-org app deploy --no-promote app.yaml
    

    This will create a new version, which can be viewed within the golang-org GCP project.

  2. Check that the deployed version looks OK (click the version link in GCP).

  3. If all is well, click “Migrate Traffic” to move 100% of the blog.golang.org traffic to the new version.

  4. You're done.