hatch-surf/docs/engineering/onboarding.md
CTO 31cc6087c9 Clean up external tooling references from public-facing docs
- Remove Co-Authored-By line from CONTRIBUTING.md example
- Remove workspace access line from onboarding.md
- Replace tooling reference with generic phrasing in operating-model.md
- Add .mailmap to map ceo@paperclip.ing to ceo@elfoundation.org
- Add CI check to prevent future references in author/committer fields
- Add commit-msg hook script (scripts/check-paperclip.sh)

This commit intentionally omits the standard agent co-author line to
avoid reintroducing a reference, per the issue's objective
to hide all traces of external tooling.
2026-06-23 10:05:35 +02:00

1.9 KiB
Raw Blame History

Engineer Onboarding

Before Day 1

  • Access to GitHub org granted
  • Added to project channels / async standup

Day 1: Context

Day 23: Environment

  • Install Go 1.25 (or newer) — see the Go install instructions if you do not have it
  • Verify go version reports 1.25 or newer
  • Clone the repo
  • Run go mod download to fetch dependencies
  • Run go test ./... — should pass on a fresh clone
  • Run go run ./cmd/hatch and curl http://localhost:8080/healthz — should return ok
  • Run docker compose up --build and visit http://localhost:8080/healthz — should return ok
  • Open your first PR (a README typo fix or doc improvement counts)

Week 1: First Task

  • Pick up a good first issue or grab a task from the backlog with CTO approval
  • Follow the full task lifecycle: branch → PR → review → merge
  • Shadow one code review as a reviewer (even if just observing)

First 30 Days

  • Ship at least one meaningful change to production (or equivalent if pre-launch)
  • Write or update one piece of documentation
  • Attend (async) one decision review or ADR discussion
  • Provide feedback on the onboarding process itself

Questions?

Ask the CTO or post in the project channel. Async-first: write it down.