# Contributing Wiki

This page complements the repository root [CONTRIBUTING.md](../../CONTRIBUTING.md).

## Fastest way to start

1. Read the root [README](../../README.md).
2. Run the local setup flow.
3. Look for issues labeled `good first issue` or `help wanted`.
4. Pick a small, self-contained task before touching larger workflow/runtime surfaces.

## What maintainers should optimize for

- a newcomer should be able to install, build, and smoke-test the repo in a few minutes
- issue descriptions should include clear reproduction or acceptance criteria
- docs, localization, wiki, and QA contributions count as real contributions
- roadmap items should be broken into slices that can be finished without deep repo archaeology

## Accepted contribution types

- code and tests
- docs and onboarding fixes
- localization updates
- issue triage and reproduction refinement
- release notes and changelog cleanup
- contributor-experience improvements

## Mentorship posture

- explain repo-local vocabulary when it is not obvious
- redirect contributors to the right doc instead of assuming they already know the surface
- prefer scoped guidance over vague “needs more work” reviews
- keep review feedback factual and actionable

## Labels that matter

- `good first issue`
- `help wanted`
- `docs`
- `localization`
- `wiki`
- `contributor experience`
- `release`

See [Good first issues and labels](./Good-First-Issues.md).