Skip to content

docs: a tool table for Python, Go, Bash and Swift - #21

Merged
thatsrue merged 1 commit into
mainfrom
docs/language-tool-table
Nov 10, 2026
Merged

thatsrue merged 1 commit into
mainfrom
docs/language-tool-table

Conversation

@thatsrue

Copy link
Copy Markdown
Collaborator

What changed

docs/repo-standards.md, Checks: a table of the tools each non-JavaScript language uses, pinned to a version.

  • Python: ruff for lint and format, pyrefly for types.
  • Go: gofmt -s, then go vet and staticcheck.
  • Bash: ShellCheck and shfmt.
  • Swift: SwiftLint and SwiftFormat.

Python installs with uv and commits uv.lock. A repo that already gates on another tool, like mypy, keeps it until it moves over.

Why

The standards named only JavaScript and TypeScript tools. The other languages were a list of examples. The owner chose a tool table only, without language-choice prose, on 2026-11-09.

The rows follow a review of current adoption and maintenance:

  • pyrefly: stable since 1.0 (2026-05-12), and already running cleanly in transcript-combobulator beside its mypy gate.
  • staticcheck: already pinned in cairn, the one Go repo.
  • Kept over the alternatives: Biome, golangci-lint, ty (still beta) and Apple's swift-format.

No issue: docs

How you checked it

  • scripts/check: 0, also through the pre-push hook.

  • Each row matches what the repos' gates run, except transcript-combobulator, which moves to uv and pyrefly next.

  • A bug fix comes with a test that fails without it

  • Docs match how it works now

  • No secrets or private information

@thatsrue
thatsrue merged commit df79f9c into main Nov 10, 2026
1 check passed
@thatsrue
thatsrue deleted the docs/language-tool-table branch November 10, 2026 04:21
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Development

Successfully merging this pull request may close these issues.

1 participant