CONTRIBUTING.md rework (#1888)

* Minor edits to first section of README

* Unify disparate Go versions across docs and workflows to Go 1.21

* Wrap up CONTRIBUTING.md rework

* Give example .vscode/launch.json file

* Try rendering YAML to avoid ugly comments

* Swap back to JSON

* Add major version release documentation

.github/workflows/ci.yml

@@ -12,7 +12,7 @@ jobs:
       - uses: actions/checkout@v4
       - uses: actions/setup-go@v4
         with:
-          go-version: '1.20.2'
+          go-version: '1.21'
       - run: make tools
       - run: make lint
       - run: make website-lint

.github/workflows/codeql.yml

@@ -26,6 +26,9 @@ jobs:
     steps:
     - name: Checkout repository
       uses: actions/checkout@v4
+    - uses: actions/setup-go@v4
+      with:
+        go-version: '1.21'
 
     # Initializes the CodeQL tools for scanning.
     - name: Initialize CodeQL

.github/workflows/dotcom-acceptance-tests-all.yml

@@ -20,6 +20,9 @@ jobs:
         with:
           ref: ${{ github.event.pull_request.head.ref }}
           fetch-depth: 2
+      - uses: actions/setup-go@v4
+        with:
+          go-version: '1.21'
       - name: Acceptance Tests (Anonymous)
         uses: terraformtesting/[email protected]
         with:
@@ -34,6 +37,9 @@ jobs:
         with:
           ref: ${{ github.event.pull_request.head.ref }}
           fetch-depth: 2
+      - uses: actions/setup-go@v4
+        with:
+          go-version: '1.21'
 
       - name: Acceptance Tests (Individual)
         id: acceptance-tests-individual
@@ -63,6 +69,9 @@ jobs:
         with:
           ref: ${{ github.event.pull_request.head.ref }}
           fetch-depth: 2
+      - uses: actions/setup-go@v4
+        with:
+          go-version: '1.21'
 
       - name: Acceptance Tests (Organization)
         id: acceptance-tests-organization

.github/workflows/dotcom-acceptance-tests-manual.yml

@@ -20,6 +20,9 @@ jobs:
         uses: actions/checkout@v4
         with:
           ref: ${{ github.event.pull_request.head.sha }}
+      - uses: actions/setup-go@v4
+        with:
+          go-version: '1.21'
       - name: Acceptance Tests (Anonymous)
         id: acceptance-tests-anonymous
         uses: terraformtesting/[email protected]
@@ -48,6 +51,9 @@ jobs:
         uses: actions/checkout@v4
         with:
           ref: ${{ github.event.pull_request.head.sha }}
+      - uses: actions/setup-go@v4
+        with:
+          go-version: '1.21'
       - name: Acceptance Tests (Individual)
         id: acceptance-tests-individual
         uses: terraformtesting/[email protected]
@@ -81,6 +87,9 @@ jobs:
         uses: actions/checkout@v4
         with:
           ref: ${{ github.event.pull_request.head.sha }}
+      - uses: actions/setup-go@v4
+        with:
+          go-version: '1.21'
 
       - name: Acceptance Tests (Organization)
         id: acceptance-tests-organization

.github/workflows/dotcom-acceptance-tests.yml

@@ -28,6 +28,9 @@ jobs:
         with:
           ref: ${{ github.event.pull_request.head.ref }}
           fetch-depth: 2
+      - uses: actions/setup-go@v4
+        with:
+          go-version: '1.21'
       - name: Acceptance Tests (Individual)
         uses: terraformtesting/[email protected]
         with:
@@ -44,6 +47,9 @@ jobs:
         with:
           ref: ${{ github.event.pull_request.head.ref }}
           fetch-depth: 2
+      - uses: actions/setup-go@v4
+        with:
+          go-version: '1.21'
       - name: Acceptance Tests (Organization)
         uses: terraformtesting/[email protected]
         with:

.github/workflows/ghes-acceptance-tests-all.yml

@@ -32,6 +32,9 @@ jobs:
         with:
           ref: ${{ github.event.pull_request.head.ref }}
           fetch-depth: 2
+      - uses: actions/setup-go@v4
+        with:
+          go-version: '1.21'
       - name: Acceptance Tests (Anonymous)
         uses: terraformtesting/[email protected]
         with:
@@ -47,6 +50,9 @@ jobs:
         with:
           ref: ${{ github.event.pull_request.head.ref }}
           fetch-depth: 2
+      - uses: actions/setup-go@v4
+        with:
+          go-version: '1.21'
 
       - name: Acceptance Tests (Individual)
         id: acceptance-tests-individual
@@ -78,6 +84,9 @@ jobs:
         with:
           ref: ${{ github.event.pull_request.head.ref }}
           fetch-depth: 2
+      - uses: actions/setup-go@v4
+        with:
+          go-version: '1.21'
 
       - name: Acceptance Tests (Organization)
         id: acceptance-tests-organization

.github/workflows/ghes-acceptance-tests.yml

@@ -27,6 +27,9 @@ jobs:
         with:
           ref: ${{ github.event.pull_request.head.ref }}
           fetch-depth: 2
+      - uses: actions/setup-go@v4
+        with:
+          go-version: '1.21'
       - name: Acceptance Tests (Anonymous)
         uses: terraformtesting/[email protected]
         with:
@@ -42,6 +45,9 @@ jobs:
         with:
           ref: ${{ github.event.pull_request.head.ref }}
           fetch-depth: 2
+      - uses: actions/setup-go@v4
+        with:
+          go-version: '1.21'
       - name: Acceptance Tests (Individual)
         uses: terraformtesting/[email protected]
         with:
@@ -59,6 +65,9 @@ jobs:
         with:
           ref: ${{ github.event.pull_request.head.ref }}
           fetch-depth: 2
+      - uses: actions/setup-go@v4
+        with:
+          go-version: '1.21'
       - name: Acceptance Tests (Organization)
         uses: terraformtesting/[email protected]
         with:

.github/workflows/release.yml

@@ -28,7 +28,7 @@ jobs:
         name: Set up Go
         uses: actions/setup-go@v4
         with:
-          go-version: 1.18
+          go-version: 1.21
       -
         name: Import GPG key
         id: import_gpg