The Vela book¶
The book explains how Vela works, one chapter per subsystem, for curious users and new contributors. SPEC.md is the reference, with every rule and constant. The book carries only the numbers needed to follow the behavior. Where the two disagree, check the code.
Every chapter has the same four parts:
- What you see: the behavior, in a user's words.
- Where the data comes from: the source, its license and its host.
- How it is decided: the rule and its constants.
- Limits: what it gets wrong and what a fix would take.
Chapters¶
| # | Chapter | Covers |
|---|---|---|
| 1 | Places on the map | Where the pins come from and which are drawn |
| 2 | Data and rebakes | The hosted datasets and when each is rebuilt |
| 3 | Surveillance cameras | The camera data, the avoid rule, the warnings |
| 4 | Navigation | The per-fix loop, rerouting, traffic rechecks |
| 5 | Routing | Whose route you drive (Google's line for driving) and where the turn instructions come from (open routers) |
| 6 | Search | Suggestions, search on Enter, offline search |
| 7 | Talking to Google | Keyless requests, the browser identity, sessions |
| 8 | Offline | What a download holds and what works with no signal |
| 9 | Transit | Departure boards, stops, transit directions |
| 10 | Android Auto and the car screen | The car screens, the snapshot map, the install gate |
| 11 | The drive's chrome | The turn banner, street callouts, the road-ahead bar |
| 12 | Releases | Channels, version codes, the in-app updater |
| 13 | Settings and page motion | The Settings pages, Back, page transitions, keypad focus |
Not written yet¶
- The map itself: label sizes, day and night styles, 3D buildings, frame rate, the layers panel (its tiles are in SPEC 10.2, Browse map).
- The route chooser: the two pickers, alternates, the camera and toll badges.
- Voices and listening: Vela voices, speech engines, voice commands.
- Keypad phones and the D-pad. For now, see docs/dpad.md.
- Trips, diagnostics and sharing: what a trip holds and what Share trims.
A behavior change updates its chapter in the same commit, or adds a line here if it has none.