[release] docs: automatically generate documentation for settings

Write a script to automatically generate settings and command
documentation using the package.json.

Also, delete the smoke-test.md file in the project root. Not sure how it
got there - probably I messed something up while renaming it.

Change-Id: I229f322d6c45bc81a456f5deb534f6591f3917d9
Reviewed-on: https://go-review.googlesource.com/c/vscode-go/+/236963
Reviewed-by: Hyang-Ah Hana Kim <[email protected]>
(cherry picked from commit 8a697ee)
Reviewed-on: https://go-review.googlesource.com/c/vscode-go/+/237159

Author: stamblerre

docs/commands.md

@@ -21,175 +21,164 @@ Finally, you can also see a full list by using a meta command: `Go: Show All Com
 
 ## Detailed list
 
-<!--TODO(rstambler): Automatically generate this list using the package.json.-->
+<!-- Everything below this line is generated. DO NOT EDIT. -->
 
-Below is a detailed list of commands. They are categorized into [code editing and generation](#code-editing-and-generation), [testing and benchmarking](#testing-and-benchmarking), [build, lint, and vet](#build-lint-and-vet), [miscellaneous](#miscellaneous), and [troubleshooting](#troubleshooting). You will find the [troubleshooting](#troubleshooting) commands helpful when diagnosing an issue with the extension (learn more in the [Troubleshooting documentation](troubleshooting.md)).
+### `Go: Current GOPATH`
 
-### Code editing and generation
+See the currently set GOPATH.
 
-<!--Note: Try to keep this list in roughly alphabetical/logical order.-->
+### `Go: Locate Configured Go Tools`
 
-#### [`Go: Add Import`](features.md#add-import)
+List all the Go tools being used by this extension along with their locations.
 
-<!--TODO(rstambler): Confirm exactly how this works.-->
-Manually add an import to your file. See [Add import](features.md#add-import).
+### `Go: Test Function At Cursor`
 
-#### [`Go: Add Package to Workspace`]
+Runs a unit test at the cursor.
 
-Add a package to the current workspace.
+### `Go: Subtest At Cursor`
 
-<!--TODO(rstambler): Figure out how this command works, its use cases, and how it fits into modules.-->
+Runs a sub test at the cursor.
 
-#### [`Go: Add Tags to Struct Fields`](features.md#add-struct-tags)
+### `Go: Benchmark Function At Cursor`
 
-Automatically generate [tags](https://pkg.go.dev/reflect?tab=doc#StructTag) for your struct. See [Add or remove struct tags](features.md#add-or-remove-struct-tags).
+Runs a benchmark at the cursor.
 
-#### [`Go: Remove Tags From Struct Fields`](features.md#add-struct-tags)
+### `Go: Debug Test At Cursor`
 
-Removes [tags](https://pkg.go.dev/reflect?tab=doc#StructTag) from the selected struct fields. See [Add or remove struct tags](features.md#add-or-remove-struct-tags).
+Debug test at the cursor.
 
-#### [`Go: Fill struct`](features.md#fill-struct-literals)
+### `Go: Test File`
 
-Fill a struct literal with default values. See [Fill struct](features.md#fill-struct-literals).
+Runs all unit tests in the current file.
 
-#### [`Go: Generate Interface Stubs`](features.md#generate-interface-implementation)
+### `Go: Test Package`
 
-Generate method stubs for given interface. See [Generate interface implementation](features.md#generate-interface-implementation).
+Runs all unit tests in the package of the current file.
 
-#### [`Go: Generate Unit Tests For Function`](features.md#generate-unit-tests)
+### `Go: Benchmark Package`
 
-Generate unit tests for the selected function in the current file. See [Generate unit tests](features.md#generate-unit-tests).
+Runs all benchmarks in the package of the current file.
 
-#### [`Go: Generate Unit Tests For File`](features.md#generate-unit-tests)
+### `Go: Benchmark File`
 
-Generate unit tests for the current file. See [Generate unit tests](features.md#generate-unit-tests).
+Runs all benchmarks in the current file.
 
-#### [`Go: Generate Unit Tests For Package`](features.md#generate-unit-tests)
+### `Go: Test All Packages In Workspace`
 
-Generate unit tests for the current package. See [Generate unit tests](features.md#generate-unit-tests).
+Runs all unit tests from all packages in the current workspace.
 
-#### [`Go: Extract to function`](features.md#refactor)
+### `Go: Test Previous`
 
-Extract the highlighted code to a function. Provided by the [`godoctor`](tools.md#godoctor) tool. Learn more about [refactoring](features.md#refactoring).
+Re-runs the last executed test.
 
-#### [`Go: Extract to variable`](features.md#refactor)
+### `Go: Toggle Test Coverage In Current Package`
 
-Extract the highlighted code to a local variable. Provided by the [`godoctor`](tools.md#godoctor) tool. Learn more about [refactoring](features.md#refactoring).
+Displays test coverage in the current package.
 
-### Testing and benchmarking
+### `Go: Generate Unit Tests For Package`
 
-#### [`Go: Test Function at Cursor`](features.md#test-and-benchmark-in-the-editor)
+Generates unit tests for the current package
 
-Run the test function at the current cursor position in the file.
+### `Go: Generate Unit Tests For File`
 
-#### [`Go: Subtest at Cursor`](features.md#test-and-benchmark-in-the-editor)
+Generates unit tests for the current file
 
-Run the subtest (`t.Run`) at the current cursor position in the file.
+### `Go: Generate Unit Tests For Function`
 
-#### [`Go: Benchmark Function At Cursor`](features.md#test-and-benchmark-in-the-editor)
+Generates unit tests for the selected function in the current file
 
-Run the benchmark at the current cursor position in the file.
+### `Go: Generate Interface Stubs`
 
-#### [`Go: Debug Test At Cursor`](features.md#debugging)
+Generates method stub for implementing the provided interface and inserts at the cursor.
 
-Debug the test at the current cursor position.
+### `Go: Add Import`
 
-#### [`Go: Test File`](features.md#test-and-benchmark-in-the-editor)
+Add an import declaration
 
-Run all of the tests in the current file.
+### `Go: Add Package to Workspace`
 
-#### [`Go: Benchmark File`](features.md#test-and-benchmark-in-the-editor)
+Add a package from the imports list to the workspace.
 
-Run all of the benchmarks in the current file.
+### `Go: Install/Update Tools`
 
-#### [`Go: Test Package`](features.md#test-and-benchmark-in-the-editor)
+install/update the required go packages
 
-Run all of the tests in the current package.
+### `Go: Toggle Test File`
 
-#### [`Go: Benchmark Package`](features.md#test-and-benchmark-in-the-editor)
+Toggles between file in current active editor and the corresponding test file.
 
-Run all of the benchmarks in the current package.
+### `Go: Add Tags To Struct Fields`
 
-#### [`Go: Test Previous`](features.md#test-and-benchmark-in-the-editor)
+Add tags configured in go.addTags setting to selected struct using gomodifytags
 
-Re-run the most recently executed test command.
+### `Go: Remove Tags From Struct Fields`
 
-#### [`Go: Test All Packages In Workspace`](features.md#test-and-benchmark-in-the-editor)
+Remove tags configured in go.removeTags setting from selected struct using gomodifytags
 
-Run all of the tests in the current workspace.
+### `Go: Fill struct`
 
-#### [`Go: Cancel Running Tests`](features.md#test-and-benchmark-in-the-editor)
+Fill a struct literal with default values
 
-Cancel currently running tests.
+### `Go: Show All Commands...`
 
-#### [`Go: Toggle Test File`](features.md#toggle-between-code-and-tests)
+Shows all commands from the Go extension in the quick pick
 
-Toggle between a file and its corresponding test file.
+### `Go: Browse Packages`
 
-#### [`Go: Apply Cover Profile`](features.md#code-coverage)
+Browse packages and Go files inside the packages.
 
-Apply a given [cover profile](https://blog.golang.org/cover) to the current file.
+### `Go: Get Package`
 
-#### [`Go: Toggle Test Coverage In Current Package`](features.md#code-coverage)
+Run `go get -v` on the package on the current line.
 
-Show [code coverage](features.md#code-coverage) in the current file.
+### `Go: Run on Go Playground`
 
-### Build, lint, and vet
+Upload the current selection or file to the Go Playground
 
-#### [`Go: Build Current Package`](features.md#build-errors)
+### `Go: Lint Current Package`
 
-Build the current package and show build errors.
+Run linter in the package of the current file.
 
-#### [`Go: Vet Current Package`](features.md#vet-errors)
+### `Go: Lint Workspace`
 
-Show vet errors for the current package.
+Run linter in the current workspace.
 
-#### [`Go: Lint Current Package`](features.md#lint-errors)
+### `Go: Vet Current Package`
 
-Show lint errors for the current package.
+Run go vet in the package of the current file.
 
-#### [`Go: Build Workspace`](features.md#build-errors)
+### `Go: Vet Workspace`
 
-Build all of the packages in the current workspace and show build errors.
+Run go vet in the current workspace.
 
-#### [`Go: Vet Workspace`](features.md#vet-errors)
+### `Go: Build Current Package`
 
-Show vet errors for all of the packages in the current workspace.
+Build the package of the current file.
 
-#### [`Go: Lint Workspace`](features.md#lint-errors)
+### `Go: Build Workspace`
 
-Show lint errors for all of the packages in the current workspace.
+Build the current workspace.
 
-#### `Go: Install Current Package`
+### `Go: Install Current Package`
 
-Install the current package and its dependencies.
+Install the current package.
 
-### Miscellaneous
+### `Go: Cancel Running Tests`
 
-#### [`Go: Restart Language Server`](gopls.md)
+Cancels running tests.
 
-Use this command to restart the [language server](gopls.md) without reloading the VS Code window. This can be helpful if something seems goes wrong with the language server (for example, if you see incorrect error messages).
+### `Go: Apply Cover Profile`
 
-#### [`Go: Run on Go Playground`](features.md#go-playground)
+Applies existing cover profile.
 
-Upload the current selection or file to the Go Playground ([play.golang.org](https://play.golang.org)). See [Go Playground](features.md#go-playground).
+### `Go: Extract to function`
 
-### Troubleshooting
+Extract to function using godoctor.
 
-#### `Go: Current GOPATH`
+### `Go: Extract to variable`
 
-See the current value of GOPATH. This is not equivalent to `go env GOPATH`, as your VS Code settings may have altered the value of `GOPATH` used by the extension. This command is helpful when [troubleshooting](troubleshooting.md) the extension.
+Extract to variable using godoctor.
 
-#### [`Go: Install/Update Tools`](tools.md)
+### `Go: Restart Language Server`
 
-Install or update the Go tools on which the extension depends. Tools can be installed or updated all at once, or individual tools can be selected.
-
-#### [`Go: Locate Configured Go Tools`](troubleshooting.md#check-your-set-up)
-
-This command is helpful when [troubleshooting](troubleshooting.md) the extension. It prints out the environment variables and paths to the tools used by the extension. See an example of the command's output in the [troubleshooting documentation](troubleshooting.md#check-your-set-up).
-
-[`golint`]: https://pkg.go.dev/golang.org/x/lint/golint?tab=overview
-[`staticcheck`]: https://pkg.go.dev/honnef.co/go/tools/staticcheck?tab=overview
-[`golangci-lint`]: https://golangci-lint.run/
-[`revive`]: https://pkg.go.dev/github.com/mgechev/revive?tab=overview
-[`gomodifytags`]: tools.md#gomodifytags
+Restart the running instance of the language server