Initial commit: Go 1.23 release state

.github/CODE_OF_CONDUCT.md

@@ -0,0 +1,3 @@
+# Code of Conduct
+
+Please read the [Go Community Code of Conduct](https://golang.org/conduct).

.github/ISSUE_TEMPLATE/00-bug.yml

@@ -0,0 +1,94 @@
+# https://docs.github.com/en/communities/using-templates-to-encourage-useful-issues-and-pull-requests/configuring-issue-templates-for-your-repository#creating-issue-forms
+# https://docs.github.com/en/communities/using-templates-to-encourage-useful-issues-and-pull-requests/syntax-for-githubs-form-schema
+name: Bugs
+description: The go command, standard library, or anything else
+title: "import/path: issue title"
+
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for helping us improve! 🙏 Please answer these questions and provide as much information as possible about your problem.
+
+  - type: input
+    id: go-version
+    attributes:
+      label: Go version
+      description: |
+        What version of Go are you using (`go version`)?
+
+        Note: we only [support](https://go.dev/doc/devel/release#policy) the two most recent major releases.
+      placeholder: ex. go version go1.20.7 darwin/arm64
+    validations:
+      required: true
+
+  - type: textarea
+    id: go-env
+    attributes:
+      label: "Output of `go env` in your module/workspace:"
+      placeholder: |
+        GO111MODULE=""
+        GOARCH="arm64"
+        GOBIN="/Users/gopher/go/bin"
+        GOCACHE="/Users/gopher/go/cache"
+        GOENV="/Users/gopher/Library/Application Support/go/env"
+        GOEXE=""
+        GOEXPERIMENT=""
+        GOFLAGS=""
+        GOHOSTARCH="arm64"
+        GOHOSTOS="darwin"
+        GOINSECURE=""
+        GOMODCACHE="/Users/gopher/go/pkg/mod"
+        GONOPROXY=""
+        GONOSUMDB=""
+        GOOS="darwin"
+        GOPATH="/Users/gopher/go"
+        GOPRIVATE=""
+        GOPROXY="https://proxy.golang.org,direct"
+        GOROOT="/usr/local/go"
+        GOSUMDB="sum.golang.org"
+        GOTMPDIR=""
+        GOTOOLDIR="/usr/local/go/pkg/tool/darwin_arm64"
+        GOVCS=""
+        GOVERSION="go1.20.7"
+        GCCGO="gccgo"
+        AR="ar"
+        CC="clang"
+        CXX="clang++"
+        CGO_ENABLED="1"
+        GOMOD="/dev/null"
+        GOWORK=""
+        CGO_CFLAGS="-O2 -g"
+        CGO_CPPFLAGS=""
+        CGO_CXXFLAGS="-O2 -g"
+        CGO_FFLAGS="-O2 -g"
+        CGO_LDFLAGS="-O2 -g"
+        PKG_CONFIG="pkg-config"
+        GOGCCFLAGS="-fPIC -arch arm64 -pthread -fno-caret-diagnostics -Qunused-arguments -fmessage-length=0 -fdebug-prefix-map=/var/folders/44/nbbyll_10jd0z8rj_qxm43740000gn/T/go-build2331607515=/tmp/go-build -gno-record-gcc-switches -fno-common"
+      render: shell
+    validations:
+      required: true
+
+  - type: textarea
+    id: what-did-you-do
+    attributes:
+      label: "What did you do?"
+      description: "If possible, provide a recipe for reproducing the error. A complete runnable program is good. A link on [go.dev/play](https://go.dev/play) is best."
+    validations:
+      required: true
+
+  - type: textarea
+    id: actual-behavior
+    attributes:
+      label: "What did you see happen?"
+      description: Command invocations and their associated output, functions with their arguments and return results, full stacktraces for panics (upload a file if it is very long), etc. Prefer copying text output over using screenshots.
+    validations:
+      required: true
+
+  - type: textarea
+    id: expected-behavior
+    attributes:
+      label: "What did you expect to see?"
+      description: Why is the current output incorrect, and any additional context we may need to understand the issue.
+    validations:
+      required: true

.github/ISSUE_TEMPLATE/01-pkgsite.yml

@@ -0,0 +1,47 @@
+name: Pkg.go.dev bugs or feature requests
+description: Issues or feature requests for the documentation site
+title: "x/pkgsite: issue title"
+labels: ["pkgsite"]
+body:
+  - type: markdown
+    attributes:
+      value: "Please answer these questions before submitting your issue. Thanks!"
+  - type: input
+    id: url
+    attributes:
+      label: "What is the URL of the page with the issue?"
+    validations:
+      required: true
+  - type: input
+    id: user-agent
+    attributes:
+      label: "What is your user agent?"
+      description: "You can find your user agent here: https://www.google.com/search?q=what+is+my+user+agent"
+    validations:
+      required: true
+  - type: textarea
+    id: screenshot
+    attributes:
+      label: "Screenshot"
+      description: "Please paste a screenshot of the page."
+    validations:
+      required: false
+  - type: textarea
+    id: what-did-you-do
+    attributes:
+      label: "What did you do?"
+      description: "If possible, provide a recipe for reproducing the error. Starting with a Private/Incognito tab/window may help rule out problematic browser extensions."
+    validations:
+      required: true
+  - type: textarea
+    id: actual-behavior
+    attributes:
+      label: "What did you see happen?"
+    validations:
+      required: true
+  - type: textarea
+    id: expected-behavior
+    attributes:
+      label: "What did you expect to see?"
+    validations:
+      required: true

.github/ISSUE_TEMPLATE/02-pkgsite-removal.yml

@@ -0,0 +1,42 @@
+name: Pkg.go.dev package removal request
+description: Request a package be removed from the documentation site (pkg.go.dev)
+title: "x/pkgsite: package removal request for [type path here]"
+labels: ["pkgsite/package-removal"]
+body:
+  - type: markdown
+    attributes:
+      value: "Please answer these questions before submitting your issue. Thanks!"
+  - type: input
+    id: package-path
+    attributes:
+      label: "What is the path of the package that you would like to have removed?"
+      description: |
+        We can remove packages with a shared path prefix.
+        For example, a request for 'github.com/author' would remove all pkg.go.dev pages with that package path prefix.
+    validations:
+      required: true
+  - type: textarea
+    id: package-owner
+    attributes:
+      label: "Are you the owner of this package?"
+      description: |
+        Only the package owners can request to have their packages removed from pkg.go.dev.
+        If the package path doesn't include your github username, please provide some other form of proof of ownership.
+    validations:
+      required: true
+  - type: textarea
+    id: retraction-reason
+    attributes:
+      label: "What is the reason that you could not retract this package instead?"
+      description: |
+        Requesting we remove a module here only hides the generated documentation on pkg.go.dev.
+        It does not affect the behaviour of proxy.golang.org or the go command.
+        Instead we recommend using the retract directive which will be processed by all 3 of the above.
+
+        If you have deleted your repo, please recreate it and publish a retraction.
+
+        Retracting a module version involves adding a retract directive to your go.mod file and publishing a new version.
+        For example: https://github.com/jba/retract-demo/blob/main/go.mod#L5-L8.
+        See https://pkg.go.dev/about#removing-a-package for additional tips on retractions.
+    validations:
+      required: true

.github/ISSUE_TEMPLATE/03-gopls.yml

@@ -0,0 +1,56 @@
+name: Gopls bugs or feature requests
+description: Issues or feature requests for the Go language server (gopls)
+title: "x/tools/gopls: issue title"
+labels: ["gopls", "Tools"]
+body:
+  - type: markdown
+    attributes:
+      value: "Please answer these questions before submitting your issue. Thanks!"
+  - type: textarea
+    id: gopls-version
+    attributes:
+      label: "gopls version"
+      description: "Output of `gopls -v version` on the command line"
+    validations:
+      required: true
+  - type: textarea
+    id: go-env
+    attributes:
+      label: "go env"
+      description: "Output of `go env` on the command line in your workspace directory"
+      render: shell
+    validations:
+      required: true
+  - type: textarea
+    id: what-did-you-do
+    attributes:
+      label: "What did you do?"
+      description: "If possible, provide a recipe for reproducing the error. A complete runnable program is good. A link on [go.dev/play](https://go.dev/play) is better. A failing unit test is the best."
+    validations:
+      required: true
+  - type: textarea
+    id: actual-behavior
+    attributes:
+      label: "What did you see happen?"
+    validations:
+      required: true
+  - type: textarea
+    id: expected-behavior
+    attributes:
+      label: "What did you expect to see?"
+    validations:
+      required: true
+  - type: textarea
+    id: editor-and-settings
+    attributes:
+      label: "Editor and settings"
+      description: "Your editor and any settings you have configured (for example, your VSCode settings.json file)"
+    validations:
+      required: false
+  - type: textarea
+    id: logs
+    attributes:
+      label: "Logs"
+      description: "If possible please include gopls logs. Instructions for capturing them can be found here: https://github.com/golang/tools/blob/master/gopls/doc/troubleshooting.md#capture-logs"
+    validations:
+      required: false

.github/ISSUE_TEMPLATE/04-vuln.yml

@@ -0,0 +1,52 @@
+name: Go vulnerability management - bugs and feature requests
+description: Issues or feature requests about Go vulnerability management
+title: "x/vuln: issue title"
+labels: ["vulncheck or vulndb"]
+body:
+  - type: markdown
+    attributes:
+      value: "Please answer these questions before submitting your issue. Thanks! To add a new vulnerability to the Go vulnerability database (https://vuln.go.dev), see https://go.dev/s/vulndb-report-new. To report an issue about a report, see https://go.dev/s/vulndb-report-feedback."
+  - type: textarea
+    id: govulncheck-version
+    attributes:
+      label: govulncheck version
+      description: What version of govulncheck are you using (`govulncheck -version`)?
+      placeholder: |
+        Go: devel go1.22-0262ea1ff9 Thu Oct 26 18:46:50 2023 +0000
+        Scanner: govulncheck@v1.0.2-0.20231108200754-fcf7dff7b242
+        DB: https://vuln.go.dev
+        DB updated: 2023-11-21 15:39:17 +0000 UTC
+    validations:
+      required: true
+  - type: textarea
+    id: reproduce-latest-version
+    attributes:
+      label: "Does this issue reproduce at the latest version of golang.org/x/vuln?"
+    validations:
+      required: true
+  - type: textarea
+    id: go-env
+    attributes:
+      label: "Output of `go env` in your module/workspace:"
+      render: shell
+    validations:
+      required: true
+  - type: textarea
+    id: what-did-you-do
+    attributes:
+      label: "What did you do?"
+      description: "If possible, provide a recipe for reproducing the error. A complete runnable program is good. A link on [go.dev/play](https://go.dev/play) is best."
+    validations:
+      required: true
+  - type: textarea
+    id: actual-behavior
+    attributes:
+      label: "What did you see happen?"
+    validations:
+      required: true
+  - type: textarea
+    id: expected-behavior
+    attributes:
+      label: "What did you expect to see?"
+    validations:
+      required: true

.github/ISSUE_TEMPLATE/10-proposal.yml

@@ -0,0 +1,15 @@
+name: Proposals
+description: New external API or other notable changes
+title: "proposal: import/path: proposal title"
+labels: ["Proposal"]
+body:
+  - type: markdown
+    attributes:
+      value: "Our proposal process is documented here: https://go.dev/s/proposal-process"
+  - type: textarea
+    id: proposal-details
+    attributes:
+      label: "Proposal Details"
+      description: "Please provide the details of your proposal here."
+    validations:
+      required: true

.github/ISSUE_TEMPLATE/11-language-change.yml

@@ -0,0 +1,165 @@
+name: Language Change Proposals
+description: Changes to the language
+labels: ["Proposal", "v2", "LanguageChange"]
+title: "proposal: Go 2: proposal title"
+
+
+body:
+  - type: markdown
+    attributes:
+      value: |
+       ## Our process for evaluating language changes can be found [here](https://go.googlesource.com/proposal/+/refs/heads/master#language-changes)
+
+  - type: dropdown
+    id: author-go-experience
+    attributes:
+      label: "Go Programming Experience"
+      description: "Would you consider yourself a novice, intermediate, or experienced Go programmer?"
+      options:
+        - "Novice"
+        - "Intermediate"
+        - "Experienced"
+      default: 1
+
+  - type: input
+    id: author-other-languages-experience
+    attributes:
+      label: "Other Languages Experience"
+      description: "What other languages do you have experience with?"
+      placeholder: "Go, Python, JS, Rust"
+    validations:
+      required: false
+
+  - type: checkboxes
+    id: related-idea
+    attributes:
+      label: "Related Idea"
+      options:
+        - label: "Has this idea, or one like it, been proposed before?"
+        - label: "Does this affect error handling?"
+        - label: "Is this about generics?"
+        - label: "Is this change backward compatible? Breaking the Go 1 compatibility guarantee is a large cost and requires a large benefit"
+
+  - type: textarea
+    id: related-proposals
+    attributes:
+      label: Has this idea, or one like it, been proposed before?
+      description: If so, how does this proposal differ?
+      placeholder: |
+       Yes or No
+
+       If yes, 
+        1. Mention the related proposals 
+        2. then describe how this proposal differs       
+    validations:
+      required: true
+
+  - type: textarea
+    id: error-handling-proposal
+    attributes:
+      label: Does this affect error handling?
+      description: If so, how does this differ from previous error handling proposals?
+      placeholder: |
+       Yes or No
+
+       If yes, 
+        1.how does this differ from previous error handling proposals?
+
+    validations:
+      required: true
+
+  - type: textarea
+    id: generics-proposal
+    attributes:
+      label: Is this about generics?
+      description: If so, how does this relate to the accepted design and other generics proposals?
+      placeholder: |
+       Yes or No
+
+       If yes, 
+        1. how does this relate to the accepted design and other generics proposals?
+
+    validations:
+      required: true
+
+  - type: textarea
+    id: proposal
+    attributes:
+      label: "Proposal"
+      description: "What is the proposed change? Who does this proposal help, and why? Please describe as precisely as possible the change to the language."
+    validations:
+      required: true
+
+  - type: textarea
+    id: language-spec-changes
+    attributes:
+      label: "Language Spec Changes"
+      description: "What would change in the language spec?"
+    validations:
+      required: false
+
+  - type: textarea
+    id: informal-change
+    attributes:
+      label: "Informal Change"
+      description: "Please also describe the change informally, as in a class teaching Go."
+    validations:
+      required: false
+
+  - type: textarea
+    id: go-backwards-compatiblity
+    attributes:
+      label: Is this change backward compatible?
+      description: Breaking the Go 1 compatibility guarantee is a large cost and requires a large benefit.
+      placeholder: |
+       Yes or No
+
+       If yes, 
+        1. Show example code before and after the change.
+
+    validations:
+      required: true
+
+  - type: textarea
+    id: orthogonality
+    attributes:
+      label: "Orthogonality: How does this change interact or overlap with existing features?"
+      description: "Is the goal of this change a performance improvement? If so, what quantifiable improvement should we expect? How would we measure it?"
+    validations:
+      required: false
+
+  - type: textarea
+    id: learning-curve
+    attributes:
+      label: "Would this change make Go easier or harder to learn, and why?"
+
+  - type: textarea
+    id: cost-description
+    attributes:
+      label: "Cost Description"
+      description: "What is the cost of this proposal? (Every language change has a cost)"
+
+  - type: input
+    id: go-toolchain
+    attributes:
+      label: Changes to Go ToolChain
+      description: "How many tools (such as vet, gopls, gofmt, goimports, etc.) would be affected? "
+    validations:
+      required: false
+
+  - type: input
+    id: perf-costs
+    attributes:
+      label: Performance Costs
+      description: "What is the compile time cost? What is the run time cost? "
+    validations:
+      required: false
+
+  - type: textarea
+    id: prototype
+    attributes:
+      label: "Prototype"
+      description: "Can you describe a possible implementation?"
+    validations:
+      required: false
+

.github/ISSUE_TEMPLATE/12-telemetry.yml

@@ -0,0 +1,30 @@
+name: Go Telemetry Proposals
+description: Changes to the telemetry upload configuration
+title: "x/telemetry/config: proposal title"
+labels: ["Telemetry-Proposal"]
+projects: ["golang/29"]
+body:
+- type: textarea
+  attributes:
+    label: Summary
+    description: >
+      What change are you proposing to the upload configuration, and why?
+      For new upload configuration, which new counters will be collected, what
+      do they measure, and why is it important to collect them?
+      Note that uploaded data must not carry sensitive user information.
+      See [go.dev/doc/telemetry#proposals](https://go.dev/doc/telemetry#proposals)
+      for more details on telemetry proposals.
+  validations:
+    required: true
+- type: input
+  attributes:
+    label: Proposed Config Change
+    description: >
+      A CL containing proposed changes to the
+      [config.txt](https://go.googlesource.com/telemetry/+/master/internal/chartconfig/config.txt)
+      chart configuration.
+      See the [chartconfig](https://pkg.go.dev/golang.org/x/telemetry/internal/chartconfig)
+      package for an explanation of the chart config format.
+      For an example change, see [CL 564619](https://go.dev/cl/564619).
+  validations:
+    required: true

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,5 @@
+blank_issues_enabled: true
+contact_links:
+  - name: Questions
+    about: Please use one of the forums for questions or general discussions
+    url:  https://go.dev/wiki/Questions

.github/PULL_REQUEST_TEMPLATE

@@ -0,0 +1,25 @@
+This PR will be imported into Gerrit with the title and first
+comment (this text) used to generate the subject and body of
+the Gerrit change.
+
+**Please ensure you adhere to every item in this list.**
+
+More info can be found at https://github.com/golang/go/wiki/CommitMessage
+
++ The PR title is formatted as follows: `net/http: frob the quux before blarfing`
+  + The package name goes before the colon
+  + The part after the colon uses the verb tense + phrase that completes the blank in,
+    "This change modifies Go to ___________"
+  + Lowercase verb after the colon
+  + No trailing period
+  + Keep the title as short as possible. ideally under 76 characters or shorter
++ No Markdown
++ The first PR comment (this one) is wrapped at 76 characters, unless it's
+  really needed (ASCII art, table, or long link)
++ If there is a corresponding issue, add either `Fixes #1234` or `Updates #1234`
+  (the latter if this is not a complete fix) to this comment
++ If referring to a repo other than `golang/go` you can use the
+  `owner/repo#issue_number` syntax: `Fixes golang/tools#1234`
++ We do not use Signed-off-by lines in Go. Please don't add them.
+  Our Gerrit server & GitHub bots enforce CLA compliance instead.
++ Delete these instructions once you have read and applied them

.github/SUPPORT.md

@@ -0,0 +1,14 @@
+Unlike many projects on GitHub, the Go project does not use its bug tracker for general discussion or asking questions.
+We only use our bug tracker for tracking bugs and tracking proposals going through the [Proposal Process](https://go.dev/s/proposal-process).
+
+For asking questions, see:
+
+* [The golang-nuts mailing list](https://groups.google.com/d/forum/golang-nuts)
+
+* [The Go Forum](https://forum.golangbridge.org/), a web-based forum
+
+* [Gophers Slack](https://gophers.slack.com), use the [invite app](https://invite.slack.golangbridge.org/) for access
+
+* [Stack Overflow](https://stackoverflow.com/questions/tagged/go) with questions tagged "go"
+
+* **IRC** channel #go-nuts on Libera