snapshot of https://github.com/toeverything/AFFiNE.git (canary, 2026-09-16; blobs > 131072B omitted)

docs/CONTRIBUTING.md

@@ -0,0 +1,36 @@
+# Contributing to AFFiNE
+
+Thank you for your interest in contributing! ❤️ AFFiNE welcomes contributions of all kinds — code, docs, bug reports, feature ideas and translations. See [types-of-contributions.md](./types-of-contributions.md) for the full picture.
+
+This page is the five-minute overview. The full contributor handbook lives at <https://docs.affine.pro/contributing>.
+
+## Before your first pull request: sign the CLA
+
+We can only merge pull requests whose authors have signed the [Contributor License Agreement](../.github/CLA.md). Every PR is checked automatically (the `license/cla` status check), and an unsigned CLA is the single most common reason PRs get stuck before merge.
+
+**How to sign (takes under a minute):**
+
+1. Open <https://cla-assistant.io/toeverything/AFFiNE>.
+2. Sign in with your GitHub account and agree.
+
+Already opened a PR? Sign, then click the **recheck** link in the CLA bot's comment on your PR (or push a new commit). Note that **every** committer on the PR must sign, and each commit's author email must be [linked to a GitHub account](https://github.com/settings/emails). See [BUILDING.md — Sign the CLA first](./BUILDING.md#sign-the-cla-first) for troubleshooting.
+
+## Contribution flow
+
+1. **Find something to work on.** Browse [good first issues](https://github.com/toeverything/AFFiNE/contribute) or the [issue tracker](https://github.com/toeverything/AFFiNE/issues). Issues that are still in triage haven't been reviewed yet — better not to start work on those. For bigger changes, open a [discussion](https://github.com/toeverything/AFFiNE/discussions) or talk to us on [Discord](https://affine.pro/redirect/discord) first.
+2. **Set up your environment.** Follow [BUILDING.md](./BUILDING.md) for the web app. For the server (cloud features) see [developing-server.md](./developing-server.md); for the desktop client see [building-desktop-client-app.md](./building-desktop-client-app.md).
+3. **Make your change** on a branch created from `canary`. Add tests where it makes sense, and run `yarn lint`, `yarn typecheck` and the relevant tests locally.
+4. **Open a PR to `canary`** with a [Conventional Commits](https://www.conventionalcommits.org/) title, e.g. `fix(editor): keep selection after paste` — the title format is enforced by CI.
+5. **Get it merged.** A PR merges once the `license/cla` check is green, CI passes, and a maintainer approves the review.
+
+## Code of conduct
+
+Please read our [Code of Conduct](./CODE_OF_CONDUCT.md).
+
+## Useful links
+
+- Codebase tour: [contributing/tutorial.md](./contributing/tutorial.md)
+- How issues are triaged: [issue-triaging.md](./issue-triaging.md)
+- Release process: [contributing/releases.md](./contributing/releases.md)
+- Reporting security issues: [SECURITY.md](../SECURITY.md)
+- Community: [Discord](https://affine.pro/redirect/discord) · [GitHub Discussions](https://github.com/toeverything/AFFiNE/discussions)