How to Read This Book
This guide is organized into numbered Parts, each building on the last. Read this short chapter once and the rest becomes self-navigating.
How the guide is organized
The numbering of the Parts sets both the reading order and the sidebar order. The Front Matter orients you; the Parts carry the substance.
| Part | Focus |
|---|---|
| Front Matter | Orientation, conventions, terminology |
| I — Foundations | The problem, the vision, the rationale |
| II — The Product | What Fyndow is — its surfaces and capabilities |
| III — How It Works | End-to-end flows and state machines |
| IV — Money | Payments, escrow, fees, refunds, and trust |
| VIII — Reference | Glossary, lookups, and FAQs |
Within a Part, chapters follow a deliberate order, but you can also jump straight to a chapter the cross-links point you to.
Reading paths
You do not have to read cover to cover. Pick the path that matches why you are here.
- New to the product? Read Foundations, then The Product. That is enough to hold an informed conversation about Fyndow.
- Want to see how things flow end to end? Read How It Works.
- Curious about payments and trust? See Money & Trust.
- Need a definition or a quick answer? Jump to Reference.
Conventions
Admonitions
The guide uses callouts to mark out-of-band information. Treat them as signals, not noise.
A note adds context or a clarification that is useful but not critical.
A tip offers a recommended approach or a shortcut.
A caution flags something easy to get wrong or a constraint to respect.
A warning marks behavior that can cause real harm — data loss, money movement, or security exposure — if mishandled.
Diagrams
Flows and state machines are drawn as diagrams that render inline. Use them as the authoritative picture of control flow and state. A state machine, for example, is drawn like this:
The diagram above is illustrative of the style; the real booking and order state machines are covered in How It Works.
Tables and cross-links
- Tables are used wherever a set of options, fields, or states is easier to scan than to read in prose.
- Cross-links are relative links between chapters, like the links to other Parts throughout this page. Follow them rather than searching; the guide is meant to be traversed.
With the conventions in hand, continue to Terminology & Conventions to learn the canonical names for the actors and objects you will meet throughout the guide.