| title | Public documentation |
|---|---|
| audience | public |
| last_updated | 2026-05-29 |
Everything in this folder is written for the end user — not for the team. It is the home for onboarding, "how the app behaves" guides, incident notices, and the legal / data-transparency text Viewpoint is obliged to publish.
It is deliberately a self-contained subtree: the same files
publish, unchanged, to the live docs site at
https://marcosbarbero.github.io/viewpoint-docs/ via the
viewpoint-docs
repo (per ADR-0070). See ADR-0043
for why this area exists and how it relates to the rest of docs/.
| Path | For |
|---|---|
getting-started.md |
First-run onboarding — what Viewpoint is, the first capture, the first map. |
offline-behavior.md |
What works with no connection, and what needs one. |
data-transparency.md |
How the forecasts and models work, and their limits. |
photo-storage.md |
How your photos are stored — per-spot limits, compression, and why. |
account-limits.md |
What Viewpoint limits and what it doesn't — the unlimited-library stance plus the few exceptions. |
incidents/ |
Dated, user-readable notices when something went wrong. |
legal/ |
Privacy policy, How analytics work, the weather-accuracy disclaimer. |
- Decisions — those are ADRs in
../decisions/. - Internal architecture / specs —
../engineering/,../product/. - Engineering incident post-mortems — internal. The
incidents/files here are the public "what happened" notice, not the root- cause analysis.
Every file in docs/public/ starts with this block:
---
title: <human title>
audience: public
last_updated: 2026-05-29
---last_updated— bump it whenever the content changes.
Files seeded before the App Store launch used to carry a
status: Draft | Published field; that was dropped on 2026-05-29
once the app launched and everything in here became published de
facto. The page-meta line on the rendered site shows only
last_updated now.