ref impl: Go linting + tests in CI

.github/workflows/go-ci.yml

@@ -0,0 +1,29 @@
+name: Go lint and test
+
+on:
+  push:
+    branches:
+      - 'main'
+      - 'staging'
+  pull_request:
+  workflow_dispatch:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Install Go
+        uses: actions/setup-go@v2
+        with:
+          go-version: ${{ matrix.go-version }}
+      - name: Checkout code
+        uses: actions/checkout@v2
+      - name: golangci-lint
+        uses: golangci/golangci-lint-action@v2
+        with:
+          version: v1.43.0  # version of golangci-lint, not the action
+          skip-go-installation: true
+          # rules: https://golangci-lint.run/usage/quick-start/
+          args: -E asciicheck,goimports
+      - name: Test
+        run: go test ./...

.github/workflows/lint.yml

@@ -4,6 +4,7 @@ on:
   push:
     branches:
       - 'main'
+      - 'staging'
   pull_request:
   workflow_dispatch:
 

meta/linting.md

@@ -1,5 +1,7 @@
 # Linting
 
+## Markdown
+
 See
 
 - [markdownlint rule reference](https://github.com/DavidAnson/markdownlint/blob/main/doc/Rules.md)
@@ -11,3 +13,28 @@ Justification for linting rules in [.markdownlint.json](/.markdownlint.json):
 - *no-blanks-blockquote*: enable multiple consecutive blockquotes separated by white lines
 - *single-title*: enable reusing `<h1>` for content
 - *no-emphasis-as-heading*: enable emphasized paragraphs
+
+```shell
+yarn           # Install dependencies
+yarn lint      # Run linter
+```
+
+## Go
+
+See
+
+- [golangci-lint docs](https://golangci-lint.run/usage/install/#local-installation)
+- [golangci-lint github](https://github.com/golangci/golangci-lint)
+- [github action github](https://github.com/golangci/golangci-lint-action)
+
+Justification for linting rules:
+
+- *asciicheck*: no symbol names with invisible unicode and such
+- *goimports*: group local and external import
+
+```shell
+# Install linter globally (should not affect go.mod)
+go install github.com/golangci/golangci-lint/cmd/golangci-lint@v1.43.0
+# run linter, add --fix option to fix problems (where supported)
+golangci-lint run -E asciicheck,goimports
+```