[release] prepare v0.27.0 release

90fee6f CHANGELOG.md: v0.27.0
49e8caf release: adjust to create CHANGELOG.md early
930647a Revert "build: build dlv-dap@89ed5a0b"
76a9457 package.json: update gopls, dlv-dap versions
d1d61bc src/goInstallTools: pin dlv-dap version @ 89ed5a0
80c1009 build: build dlv-dap@89ed5a0b
2a9fb96 src/welcome: mention that dlv-dap is the default debug adapter
a6066b7 docs: move dlv-dap to debugging, debugging to debugging-legacy
ed64853 src/goToolsInformation: update dlv-dap latest version
e66ec8d src/goDebugConfiguration: enable dlv-dap for local debugging
7502135 dlv-dap.md: use normal quotes
6658964 docs/dlv-dap.md: update remote debugging section
f2477e0 src/debugAdapter: send continued event on step requests
2e0c640 src/goMain: let go.locate.tools print tools versions
b9b3b47 README.md: encourage stackoverflow for Q&A
e6b8fe7 src/goInstallTools.ts: correct spacing in error message on Go not found
80c1b5c tools/relnotes: make some changes to generate release notes for gopls
2e8e703 src/goDebugConfiguration: dlv-dap doesn't expect 'wd'
15aaa8c src/goDebugFactory,src/goDebug: only add --log-output flag if --log is set
93a6e13 package.json: add go.terminal.activateEnvironment setting
29634d6 .github/workflows: add go1.17 rc1 in the long tests
b10aae5 src/config.ts: add Gitpod to the known cloud-based IDEs
805b29c src/goTest.ts: prompt for subtest name if there is no subtest at cursor
800dd70 tools: include script to help generate CHANGELOG
dee3427 docs: add minimum VS Code engine to troubleshooting guide
58226c9 src/goDebugConfiguration: always set cwd in attach mode & legacy adapter
72e205b docs/dlv-dap.md: update dlv-dap documentation
48418d4 test/integration/goDebug: enable set breakpoints while running tests
c3516da test/integration/goDebug: enable tests for delve flags
9b2405c test/integration/goDebug: enable tests skipped in dlv-dap mode
d0699a0 docs/dlv-dap: fix typos and errors in formatting
39d70a6 docs/dlv-dap: add features and images
a5d232d tools/generate: make debug property order deterministic
289a9ef docs/contributing.md: update docs to reflect npm version requirements
c6c97b9 tools/generate: generate debug configuration table
b2119e2 package.json: change version to v0.27.0-dev
689bf6f CHANGELOG.md: v0.26.0 change log & mention dlv-dap in README.md
dac1500 package.json: update debug configuration
7280045 tools/generate: simplify Properties parsing
2debbe8 .vscode/launch.json: Launch tools/generate
27bbf42 src/goToolsInformation: update dlv-dap@688f94a

Change-Id: I1771cc86d8c9e435e66b13da99931833536f1ae2

Author: hyangah

.github/ISSUE_TEMPLATE/bug_report.md

@@ -8,7 +8,8 @@ assignees: ''
 ---
 
 For asking questions, see:
-- [GitHub Discussions (Q&A)](https://github.com/golang/vscode-go/discussions/categories/q-a)
+- [Stack Overflow](https://stackoverflow.com/questions/tagged/go+visual-studio-code)
+- [GitHub Discussions (Help)](https://github.com/golang/vscode-go/discussions/categories/help)
 - [`#vscode` channel in Gophers Slack](https://invite.slack.golangbridge.org/messages/vscode)
 
 Before filing an issue, please review our troubleshooting guides

.github/ISSUE_TEMPLATE/config.yml

@@ -1,5 +1,5 @@
 blank_issues_enabled: false
 contact_links:
   - name: Question
-    url: https://invite.slack.golangbridge.org/
-    about: Ask and answer questions on the `#vscode` channel in Gophers Slacks.
+    url: https://stackoverflow.com/questions/tagged/go+visual-studio-code
+    about: Ask and answer questions on Stack Overflow.

.github/SUPPORT.md

@@ -1,6 +1,6 @@
 For asking questions, visit:
 
-* `#vscode` channel in [Gophers Slack](https://gophers.slack.com) for general questions.
-* `#vscode-dev` channel in [Gophers Slack](https://gophers.slack.com) for extension development-related questions.
-
-Use the [invite app](https://invite.slack.golangbridge.org/) for access.
+* [Stack Overflow](https://stackoverflow.com/questions/tagged/go+visual-studio-code)
+* [Gophers Slack](https://gophers.slack.com) - Use the [invite app](https://invite.slack.golangbridge.org/) for access.
+	* `#vscode` channel for general questions
+	* `#vscode-dev` channel for extension development-related questions

.github/release_plan.md

@@ -4,23 +4,23 @@
 -   [ ] Create a milestone with the issues that are fixed by this release
 -	[ ] Update `master` for the release
 	-	[ ] Update hardcoded latest version for `dlv-dap` and `gopls`
+	-   [ ] Update [`CHANGELOG.md`](https://github.com/golang/vscode-go/blob/master/CHANGELOG.md)
+        -   [ ] Make sure the "Thanks" section is up-to-date
+        -   [ ] Check the Markdown rendering to make sure everything looks good
 -   [ ] Update `release` for the release
     -   [ ] Create a branch against `release` for a pull request
     -   [ ] Merge changes from `master` to prepare for the release
     -   [ ] Change the version in [`package.json`](https://github.com/golang/vscode-go/blob/master/package.json) from a `-dev` suffix
     -   [ ] Run `npm install` to make sure [`package-lock.json`](https://github.com/golang/vscode-go/blob/master/package.json) is up-to-date
     -   [ ] Update the license file (`$ tools/license.sh; mv LICENSE.prod LICENSE`)
-	-   [ ] Update [`CHANGELOG.md`](https://github.com/golang/vscode-go/blob/master/CHANGELOG.md)
-        -   [ ] Make sure the "Thanks" section is up-to-date
-        -   [ ] Check the Markdown rendering to make sure everything looks good
 -   [ ] Check the [Long Tests status](https://github.com/golang/vscode-go/actions?query=workflow%3A%22Long+Tests%22)  is green. Otherwise, fix the tests, send cls for review, submit them, and repeat. 
 -   [ ] Perform manual [smoke tests]( https://github.com/golang/vscode-go/blob/master/docs/smoke-test.md)
 -   [ ] Create new version tag for X.XX.X-rc.1 at gerrit’s vscode-go [repo management page](https://go-review.googlesource.com/admin/repos/vscode-go,tags)
 -   [ ] Go to the release page https://github.com/golang/vscode-go/releases and check if the new release candidate is up. If necessary, you can manually edit the comment by clicking the “Edit” button. Don’t mutate uploaded vsix.
 -   [ ] Ask editor team and contributors to this release to test the release candidate
 
 # Release Candidate >1 (if necessary)
-- 	 ] Fix any bugs on `master` and cherry pick changes to `release
+- 	[ ] Fix any bugs on `master` and cherry pick changes to `release
 -   [ ] Create new version tag for X.XX.X-rc.1 at gerrit’s vscode-go [repo management page](https://go-review.googlesource.com/admin/repos/vscode-go,tags)
 -   [ ] Go to the release page https://github.com/golang/vscode-go/releases and check if the new release candidate is up. If necessary, you can manually edit the comment by clicking the “Edit” button. Don’t mutate uploaded vsix.
 -   [ ] Ask editor team and contributors to this release to test the release candidate
@@ -36,4 +36,3 @@
     -   [ ] Bump the version number to the next monthly ("X.XX.X-dev") release in the `master` branch
         -   [ ] `package.json`
         -   [ ] `package-lock.json`
-    -   [ ] Cherry pick CHANGELOG.md back to master

.github/workflows/test-long-all.yml

@@ -17,7 +17,7 @@ jobs:
       matrix:
         os: [ubuntu-latest, windows-latest, macos-latest]
         version: ['stable', 'insiders']
-        go: ['1.15', '1.16']
+        go: ['1.15', '1.16', '1.17.0-rc1']
 
     steps:
       - name: Clone repository

.github/workflows/test-long.yml

@@ -16,7 +16,7 @@ jobs:
       matrix:
         os: [ubuntu-latest, windows-latest] # TODO: reenable macos-latest
         version: ['stable']
-        go: ['1.15', '1.16']
+        go: ['1.15', '1.16', '1.17.0-rc1']
 
     steps:
       - name: Clone repository

.vscode/launch.json

@@ -1,6 +1,14 @@
 {
 	"version": "0.2.0",
 	"configurations": [
+		{
+			"name": "Launch tools/generate",
+			"type": "go",
+			"request": "launch",
+			"mode": "debug",
+			"program": "${workspaceFolder}/tools/generate.go",
+			"cwd": "${workspaceFolder}"
+		},
 		{
 			"name": "Launch Extension",
 			"type": "extensionHost",

CHANGELOG.md

@@ -1,4 +1,42 @@
-## V0.26.0 - 17 Jun, 2021
+## v0.27.0 - 8 Aug, 2021
+
+📣 Delve's native DAP implementation ([`dlv-dap`](https://github.com/go-delve/delve/blob/master/Documentation/usage/dlv_dap.md))
+is enabled by default for local debugging. We updated the [Documentation for Debugging](https://github.com/golang/vscode-go/blob/master/docs/debugging.md)
+to show the new features available with dlv-dap. This change does not apply to remote debugging yet.
+For remote debugging, keep following the instruction in the
+[legacy debug adapter documentation](https://github.com/golang/vscode-go/blob/master/docs/debugging-legacy.md).
+
+A list of all issues and changes can be found in the [v0.27.0 milestone](https://github.com/golang/vscode-go/milestone/33?closed=1) and [commit history](A list of all issues and changes can be found in the [v0.26.0 milestone](https://github.com/golang/vscode-go/milestone/30?closed=1) and [commit history](https://github.com/golang/vscode-go/compare/v0.27.0...v0.26.0).
+
+### Enhancements
+- The new [`go.terminal.activateEnvironment`](https://github.com/golang/vscode-go/blob/master/docs/settings.md#goterminalactivateenvironment)
+allows to prevent the extension from changing integrated terminal's environment variables. ([Issue 1558](https://github.com/golang/vscode-go/issues/1558), [1098](https://github.com/golang/vscode-go/issues/1098)) <!-- CL 336409 -->
+- The [`Go: Locate Configured Go Tools`](https://github.com/golang/vscode-go/blob/master/docs/commands.md#go-locate-configured-go-tools)
+command prints the build information of detected tools. <!-- CL 337989 -->
+- Use `dlv-dap` as the default debug adapter for local debugging. The new debug adapter offers
+[many new features and improvements](https://github.com/golang/vscode-go/issues?q=is%3Aissue+is%3Aclosed+label%3AFixedInDlvDAPOnly).
+- Added Gitpod to a recognized Cloud-based IDE, for which the extension will minimize the number of toast or notification messages. ([Issue 1616](https://github.com/golang/vscode-go/issues/1616)) 
+- The [`Go: Subtest At Cursor`](https://github.com/golang/vscode-go/blob/master/docs/commands.md#go-subtest-at-cursor) command prompts for subtest name if there is no subtest at cursor ([Issue 1602](https://github.com/golang/vscode-go/issues/1602)). <!-- CL 333309 -->
+
+### Fixes
+- Debugging
+    - Setting the `logOutput` property without `showLog: true` does not break debugging any more. <!-- CL 335029 -->
+    - Fixed a bug in the legacy debug adapter that caused jumping at each step after upgrading to VS Code 1.58+. ([Issue 1617](https://github.com/golang/vscode-go/issues/1617), [1647](https://github.com/golang/vscode-go/issues/1647)) <!-- CL 338194 -->
+    - Fixed a bug that broke Attach mode debugging using the legacy debug adapter if `cwd` is not set. ([Issue 1608](https://github.com/golang/vscode-go/issues/1608)) <!-- CL 334111 --> 
+
+### Code Health
+- The version of `dlv-dap` is pinned to [v1.7.1-0.20210804080032-f95340ae1bf9](https://github.com/go-delve/delve/tree/f95340ae1bf9fed8740d5fd39f5758d41770d967) and `dlv-dap` is marked as a required tool.
+- Updated the hard-coded default gopls version string to v0.7.1.
+- Added `tools/relnotes`, a script to help generate CHANGELOG.md. <!-- CL 256579 -->
+- Added go1.17 RC to CI. ([Issue 1640](https://github.com/golang/vscode-go/issues/1640)) <!-- CL 336310 -->
+- Enabled tests that were skipped in dlv-dap mode since dlv-dap reached feature parity. <!-- CL 332109 -->
+- Use StackOverflow as the channel for Q&A.
+
+### Thanks
+
+Thank you for your contribution, Ahmed W, Hana, Michael Currin, Polina Sokolova, Rebecca Stambler, Suzy Mueller, and Sven Efftinge!
+
+## v0.26.0 - 17 Jun, 2021
 
 📣 [`Delve`'s native DAP implementation](https://github.com/golang/vscode-go/blob/master/docs/dlv-dap.md) is now available for use. In order to use this new debug adapter (`dlv-dap`) when debugging Go programs, add the following settings in your `settings.json`:
 

README.md

@@ -8,8 +8,8 @@
 provides rich language support for the
 [Go programming language](https://golang.org/).
 
-> 📣 Debugging using [`Delve`'s native DAP implementation](https://github.com/golang/vscode-go/blob/master/docs/dlv-dap.md) is now available for use.<br>
-> Please test it by following [the instruction to enable this new feature](https://github.com/golang/vscode-go/blob/master/docs/dlv-dap.md#getting-started) and share your feedback!
+
+> 📣 Debugging using [`Delve`'s native DAP implementation](https://github.com/golang/vscode-go/blob/master/docs/debugging.md) is enabled by default in v0.27.0.<br>
 
 ## Quick Start
 
@@ -130,8 +130,7 @@ troubleshooting](docs/troubleshooting.md), and another specifically for
 If the troubleshooting guides did not resolve the issue, please reach out to us
 by [filing an issue](https://github.com/golang/vscode-go/issues/new/choose),
 [starting a GitHub discussion](https://github.com/golang/vscode-go/discussions),
-or by asking a question in the [Gophers Slack]. We hang out in the `#vscode`
-channel!
+or by asking a question on [Stack Overflow].
 
 Also, you can take a look at [learn.go.dev](https://learn.go.dev) and
 [golang.org/help](https://golang.org/help) for more general guidance on using
@@ -161,7 +160,7 @@ conduct-related issue, please mail [email protected].
 
 [MIT](LICENSE)
 
-[Gophers Slack]: https://gophers.slack.com/
+[Stack Overflow]: https://stackoverflow.com/questions/tagged/go+visual-studio-code
 [`gopls`]: https://golang.org/s/gopls
 [`go`]: https://golang.org/cmd/go
 [Managing extensions in VS Code]: https://code.visualstudio.com/docs/editor/extension-gallery

docs/contributing.md

@@ -34,7 +34,7 @@ Please note that extra configuration is required to build and run the [Debug Ada
 
 ### Setup
 
-1) Install [node](https://nodejs.org/en/).
+1) Install [node](https://nodejs.org/en/). Note: make sure that you are using `npm v7` or higher. The file format for `package-lock.json` (changed significantly)[https://docs.npmjs.com/cli/v7/configuring-npm/package-lock-json#file-format] in `npm v7`.
 2) Clone the repository, run `npm install`, and open VS Code:
 
     ```bash