# Developer documentation in English

Полка's product and its main README are Russian-first; everything a developer needs to contribute is in English. Start with the README, then the architecture.

| Document | What it covers |
|---|---|
| [README_EN.md](../../README_EN.md) | What Полка is, connecting agents, running it, self-hosting |
| [architecture.md](architecture.md) | What runs where, data, how a page reaches the recipient, extension points, trust boundaries, the code map and three files to read first |
| [local-development.md](local-development.md) | Local setup, ports, tests and `npm run verify`, the interactive viewer, mail, agents and sessions locally, the restore drill |
| [CONTRIBUTING.md](../../CONTRIBUTING.md) | Checks before a pull request, house rules, commits, pull requests and releases, the CLA |
| [SECURITY.md](../../SECURITY.md) | How to report a vulnerability (privately), supported versions, the threat model (mostly Russian) |
| [COMMERCIAL.md](../../COMMERCIAL.md#open-core-and-commercial-edition-summary-in-english) | Open core and the commercial edition, summary in English |

The rest of [`docs/`](../README.md), including the specifications in `docs/specs/`, is in Russian.