Skip to content

docs: add contributor onboarding guide#164

Open
YimingIsCOLD wants to merge 7 commits into
mainfrom
docs/contributor-onboarding
Open

docs: add contributor onboarding guide#164
YimingIsCOLD wants to merge 7 commits into
mainfrom
docs/contributor-onboarding

Conversation

@YimingIsCOLD
Copy link
Copy Markdown
Contributor

@YimingIsCOLD YimingIsCOLD commented May 10, 2026

🚀 Summary

Adds contributor onboarding documentation. Establishes CONTRIBUTING.md as the canonical home for human-facing conventions (style, tests, commits, PRs) and slims CLAUDE.md to a @CONTRIBUTING.md import so Claude Code's context stays complete without duplication. Adds supporting tooling: a Makefile for pinned golangci-lint installation and prerequisite documentation for Go, Node, and pnpm versions.

✏️ Changes

  • Add README.md with project overview, quick start, and contributing pointer.
  • Add CONTRIBUTING.md covering development setup, project structure, branching workflow, code style, test conventions, commit conventions, and PR process.
  • Slim CLAUDE.md to a @CONTRIBUTING.md import.
  • Add Makefile with pinned golangci-lint (v2.11.4) installed into ./bin/.
  • Add bin/ to .gitignore.
  • Document minimum tool versions (Go 1.26.1+, Node.js 24+, pnpm 11+) with mise use --global as the recommended install path.
  • Drop the golint script from package.json in favor of make lint (which uses the pinned golangci-lint).

🧪 Test Plan

  • make tools installs golangci-lint v2.11.4 into ./bin/golangci-lint-v2.11.4.
  • make lint runs the linter without errors.
  • Internal links in README.md and CONTRIBUTING.md resolve correctly on GitHub.
  • pnpm dev:all still starts the stack.

@YimingIsCOLD YimingIsCOLD self-assigned this May 10, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants