[mirror] Home of the go.dev and golang.org websites
Перейти к файлу
Robert Griesemer f5512f03a0 _content/doc: update Go 1.18 release notes
Document field access limitations for type parameters.

Also, remove some superfluous "currently" uses - the
time context is clear from the introductory paragraph
of the respective section.

For golang/go#51576.
For golang/go#47694.

Change-Id: If4c12f95f024894a9efb949dda9341d8ab0dc77e
Reviewed-on: https://go-review.googlesource.com/c/website/+/391279
Reviewed-by: DO NOT USE <iant@google.com>
Trust: Dmitri Shuralyov <dmitshur@google.com>
2022-03-10 00:39:42 +00:00
_content _content/doc: update Go 1.18 release notes 2022-03-10 00:39:42 +00:00
_later/security go.dev: merge go.dev/_content into root _content 2021-11-22 16:42:59 +00:00
cmd internal/web: fix syntax rules hyperlinks 2022-03-07 15:05:08 +00:00
internal internal/web: fix syntax rules hyperlinks 2022-03-07 15:05:08 +00:00
tour website: update deploying sections in README files 2021-12-06 17:29:19 +00:00
.eslintrc.yaml website: add support for JS/TS unit testing 2022-01-11 22:46:10 +00:00
.gitattributes blog: delete per-repo files, update README.md, go.mod 2021-05-26 13:23:13 +00:00
.prettierrc.yaml go.dev: merge go.dev/_content into root _content 2021-11-22 16:42:59 +00:00
.stylelintrc.yaml website: fixed stylelint dependency 2022-01-11 22:47:06 +00:00
AUTHORS initial commit 2019-01-04 09:34:42 -05:00
CONTRIBUTING.md initial commit 2019-01-04 09:34:42 -05:00
CONTRIBUTORS initial commit 2019-01-04 09:34:42 -05:00
LICENSE initial commit 2019-01-04 09:34:42 -05:00
PATENTS initial commit 2019-01-04 09:34:42 -05:00
README.md website: add support for JS/TS unit testing 2022-01-11 22:46:10 +00:00
codereview.cfg x/website: add code and static files for website 2019-01-08 18:22:29 +00:00
content.go internal/tour: fix go.dev/tour 2021-11-23 03:31:47 +00:00
go-app-deploy.sh website: publish all commits, eliminating Website-Publish+1 vote 2021-12-06 20:46:19 +00:00
go.mod internal/screentest: add support for writing test output to GCS 2022-01-04 19:30:38 +00:00
go.sum internal/screentest: add support for writing test output to GCS 2022-01-04 19:30:38 +00:00
jest-transform.cjs website: add support for JS/TS unit testing 2022-01-11 22:46:10 +00:00
npm website: add support for JS/TS unit testing 2022-01-11 22:46:10 +00:00
npx website: add support for JS/TS unit testing 2022-01-11 22:46:10 +00:00
package-lock.json website: fixed stylelint dependency 2022-01-11 22:47:06 +00:00
package.json website: fixed stylelint dependency 2022-01-11 22:47:06 +00:00
tsconfig.json website: add support for JS/TS unit testing 2022-01-11 22:46:10 +00:00

README.md

Go website

Go Reference

This repo holds content and serving programs for the go.dev and golang.org web sites.

Content is in _content/ (go.dev) and tour/ (go.dev/tour). Server code is in cmd/ and internal/.

To run the combined go.dev+golang.org server to preview local content changes, use:

go run ./cmd/golangorg

The supporting programs cmd/admingolangorg and cmd/googlegolangorg are the servers for admin.golang.org and google.golang.org. (They do not use the _content/ directories.)

Each command directory has its own README.md explaining deployment.

JS/TS/CSS Formatting

This repository uses eslint to format JS and TS files, and stylelint to format CSS files.

See also:

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

Installing npm Dependencies:

  1. Install docker
  2. Create a .gitignore file at repo root
  3. Add .gitignore and node_modules to .gitignore
  4. Run ./npm install

Run ESlint

./npx eslint [options] [file] [dir]

Run Stylelint

./npx stylelint [input] [options]

TypeScript Support

TypeScript files served from _content are transformed into JavaScript. Reference .ts files in html templates as module code.

<script type="module" src="/ts/filename.ts">

Write unit tests for TypeScript code using the jest testing framework.

Run Jest

./npx jest [TestPathPattern]

Deploying

Each time a CL is reviewed and submitted, the code is deployed to App Engine. See cmd/golangorg/README.md for details.

Report Issues / Send Patches

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

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