---
url: /start.md
description: >-
  Six paths through the Wow documentation, one for each kind of reader, each
  with the pages to read in order.
---

# Start Here

Pick the path that matches what you came to do. Each lists the pages to read in order; the rest of the site is there when you need it.

## Deciding whether to use Wow

1. [Why Wow](./why-wow): what it does, the principles, what it assumes, and when it is not the right tool.
2. [Quickstart](./quickstart): one service from an empty project to a command sent and its state read, in about thirty minutes.
3. [Concepts](../concepts/): the log, the write path, subscriptions, read models and the contract.
4. [Tutorial](./tutorial): two contexts working together, from a basket to an order.

## Building a service in Kotlin or Java

1. [Quickstart](./quickstart), or [Add Wow to an Existing Service](./existing-project).
2. [Guide](../guide/): aggregates and rejections, sagas, projections, reading and querying, calling other services, testing, and the Spring Boot host.
3. [Agent Skills](./skills): the `wow-develop` Skill writes, reviews and diagnoses with you.

## Calling a service from TypeScript

1. [TypeScript](../typescript/): the packages and what each one does.
2. [Generate a Client](../typescript/generate), [Send Commands](../typescript/commands), [Read and Query](../typescript/queries).
3. [View Engine](../typescript/view-engine/), for views users configure.

## Running Wow in production

1. [Running Wow](../operate/): what a deployment is made of.
2. [Deployment Model](../operate/topology), [Configure a Service](../operate/configuration), [Kubernetes](../operate/kubernetes).
3. [Health, Metrics and Tracing](../operate/observability), [Troubleshooting](../operate/troubleshooting), [The Ops Service and Console](../operate/ops-console).

## Analyzing the data

1. [Data in a Wow System](../data/): the three models a query reads.
2. [Query for Analysis](../data/querying), then the [Query Language](../reference/query-language).
3. [Datasets and the Analytics Catalog](../data/datasets), [The Workbench](../data/workbench).

## Moving from 9.x

1. [Migrating from 9.x](../migrate/): what changes and the way across.
2. [9.x Capabilities in V10](../migrate/capabilities), then [Migrate the Source](../migrate/source).
3. [Migrate the Data](../migrate/data) and [Cut Over](../migrate/cutover).

Contributing to Wow itself starts with [Codebase Tour](../contribute/).