From cc93fd30fcfcb546131b9448a5637dead3e88953 Mon Sep 17 00:00:00 2001 From: Will Hawkins Date: Fri, 19 May 2023 13:01:18 -0400 Subject: Add VSCode Configuration Information Using `gofumpt` via `gopls` makes it easier to maintain our 100-character-per-line limit. A `settings.json` file makes it easier to configure and instructions in the `README.md` help, too. --- README.md | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) (limited to 'README.md') diff --git a/README.md b/README.md index d99f2ac..61254ce 100644 --- a/README.md +++ b/README.md @@ -127,6 +127,22 @@ As a bonus, there are unit tests to check for regressions: $ go test ./timeoutat ./ms ./utilities ./traceable ``` +### IDE Configuration + +If you are developing with VSCode, you can use `ide/settings.json` as the +[workspace's](https://code.visualstudio.com/docs/editor/workspaces) `settings.json` file +in order to meet the project's existing style. In particular, this file will configure +VSCode to use an alternate go formatter known as [`gofumpt`](https://github.com/mvdan/gofumpt) +and, in turn, give `gofumpt` specific configuration directives. + +To use the included `settings.json` file, simply drop it in the `.vscode` directory of the folder +containing this `README.md` file. + +>Note: If you have existing workspace settings, you may be required to take additional +steps to incorporate the information in the given `settings.json` file. + +> You may have to create the `.vscode` directory if it does not already exist. + ## References [RFC2026] https://datatracker.ietf.org/doc/html/rfc2026 -- cgit v1.2.3