### Source Peer feedback, collected in #167. Quotes (translated): the documentation is very extensive (the README is 45 kB and API.md 80 kB), so a shorter overview with links would make it easier to find; I could not find where the database search is done; the system is very big and hard to find your way around. ### Related #148 (the docs are outdated) and #153 (state management). This issue is about the size and the way in, not about what is out of date. ### What to do - [ ] Make the README an overview: what the project is, how to run it, and a table of links to the documents. Move long explanations to `docs/` and keep one or two sentences with a link in the README. - [ ] Add a short "where is what" map: for each main feature (search, the catalog, the gymnast pages, login) the file where it starts (for example the resolver and `backend/src/catalog/search.ts` for the database search). - [ ] Say in `docs/API.md` at the top what is in it, with a table of contents. - [ ] Do not delete the reasoning, only move it. ### Done when - [ ] A new reader finds the database search, the state and the tests from the README in two clicks, and the README is a fraction of its present size. _Comment made with Claude Code in discussion with Ronja_