content/static/doc: add introduction, resolve several TODOs

* Added Introduction. This should say generally what modules are. It
  should also say this is a reference document, and point to tutorials
  for folks looking for those.
* Edited some text in introductory sessions.
* Replaced emphasis on new terms with <dfn> tags. Dropped emphasis
  from terms that are being mentioned, not defined.
* Added glossary term for "vendor directory".
* Removed some TODOs that are no longer relevant.

For golang/go#33637

Change-Id: Iae6dcd28b392a4cd94351bc645a059ead3a7dfa8
Reviewed-by: Bryan C. Mills <>
Reviewed-by: Michael Matloob <>
2 files changed
tree: 9d417291c2b0dbb2e07c97e05623caf7203a0257
  1. .prettierrc
  8. cmd/
  9. codereview.cfg
  10. content/
  11. favicon.ico
  12. go.mod
  13. go.sum
  14. internal/
  15. robots.txt

Go website

This repository holds the Go website server code and content.

Checkout and Run

To download and run the web server locally:

  • git clone
  • cd website
  • go run ./cmd/golangorg
  • Open http://localhost:6060/ in your browser.

See cmd/golangorg/ for more details.

Changing Content

To make basic changes to the website content:

  • Make the changes you want in the content/static directory.
  • Stop any running go run ./cmd/golangorg.
  • go generate ./content/static
  • go run ./cmd/golangorg
  • Open http://localhost:6060/ in your browser.

See content/ for more sophisticated instructions.

JS/CSS Formatting

This repository uses prettier to format JS and CSS files.

The version of prettier used is 1.18.2.

It is encouraged that all JS and CSS code be run through this before submitting a change. However, it is not a strict requirement enforced by CI.

Report Issues / Send Patches

This repository uses Gerrit for code changes. To learn how to submit changes to this repository, see

The main issue tracker for the website repository is located at Prefix your issue with “x/website:” in the subject line, so it is easy to find.