docs: move detailed setup notes into docs and simplify README (#348)

This refactors the top-level README into a lighter project landing page and moves detailed setup and usage material into `docs/`.

- simplify the root `README.md`
- add focused documentation pages under `docs/`
- fix and update README links and badges
- clarify build vs runtime requirements

Author: plexoos