# Topaz documentation index

> Topaz is a compact, Unicode-first application language with one consistent
> source syntax and Rust, Python, and web output options.

## Cache-safe version check

- This index describes Topaz v5.20.
- Machine-readable version metadata: https://topaz.ooo/version.json
- Before trusting any documentation page, fetch that metadata and compare its
  version field with the version named by the page.
- If they differ, discard the cached page and refetch the matching URL from
  this index.
- HTML version metadata: <meta name="topaz-version" content="5.20">.
- Language and compatibility: https://topaz.ooo/v5.20/en/docs/project/conformance

## Canonical v5.20 pages

### Start Here

- Introducing Topaz: https://topaz.ooo/v5.20/en/docs/introduction
- Learning path: https://topaz.ooo/v5.20/en/docs/learn
- Coming From Other Languages: https://topaz.ooo/v5.20/en/docs/learn/coming-from-other-languages
- What a Program Is: https://topaz.ooo/v5.20/en/docs/learn/what-a-program-is
- First Program: https://topaz.ooo/v5.20/en/docs/getting-started

### Learn Topaz

- Values and Functions: https://topaz.ooo/v5.20/en/docs/learn/values-functions
- Data and Control: https://topaz.ooo/v5.20/en/docs/learn/data-control
- Failures and Resources: https://topaz.ooo/v5.20/en/docs/learn/failures-resources
- First Application: https://topaz.ooo/v5.20/en/docs/learn/first-application
- Reading a Real File: https://topaz.ooo/v5.20/en/docs/learn/reading-topaz
- Syntax at a Glance: https://topaz.ooo/v5.20/en/docs/language-tour

### Build Applications

- Application Loop: https://topaz.ooo/v5.20/en/docs/guides/application-loop
- Run Lispex Rules: https://topaz.ooo/v5.20/en/docs/guides/lispex-application
- Data Lens: https://topaz.ooo/v5.20/en/docs/guides/data-lens
- HTTP Service: https://topaz.ooo/v5.20/en/docs/guides/http-service

### Language Foundations

- Lexical Structure & Layout: https://topaz.ooo/v5.20/en/docs/language/lexical-layout
- Operators & Expressions: https://topaz.ooo/v5.20/en/docs/language/operators-expressions
- Types: https://topaz.ooo/v5.20/en/docs/language/types
- Bindings, Scope & Closures: https://topaz.ooo/v5.20/en/docs/language/bindings-scope-closures

### Data & Control

- Patterns & Control Flow: https://topaz.ooo/v5.20/en/docs/language/patterns-control-flow
- Functions & Generics: https://topaz.ooo/v5.20/en/docs/language/functions-generics
- Records & Nominal Data: https://topaz.ooo/v5.20/en/docs/language/records-nominal-data
- Collections & Comprehensions: https://topaz.ooo/v5.20/en/docs/language/collections-comprehensions
- Pipelines & Placeholders: https://topaz.ooo/v5.20/en/docs/language/pipelines-placeholders

### Program Structure

- Null, Option, Result & Faults: https://topaz.ooo/v5.20/en/docs/language/null-option-result-faults
- Defer & Resources: https://topaz.ooo/v5.20/en/docs/language/defer-resources
- Concurrency: https://topaz.ooo/v5.20/en/docs/language/concurrency
- Strings & Templates: https://topaz.ooo/v5.20/en/docs/language/strings-templates
- Modules & Visibility: https://topaz.ooo/v5.20/en/docs/language/modules-visibility
- Forbidden & Deferred Forms: https://topaz.ooo/v5.20/en/docs/language/forbidden-deferred

### Standard Library & Runtime

- Standard Library Overview: https://topaz.ooo/v5.20/en/docs/stdlib/overview
- Core Library: https://topaz.ooo/v5.20/en/docs/stdlib/core
- Collection Operations: https://topaz.ooo/v5.20/en/docs/stdlib/collections
- Files & Resources: https://topaz.ooo/v5.20/en/docs/stdlib/files-resources
- Runtime Behavior: https://topaz.ooo/v5.20/en/docs/runtime/behavior

### About Topaz

- Language Philosophy: https://topaz.ooo/v5.20/en/docs/philosophy
- History: https://topaz.ooo/v5.20/en/docs/project/history

### Tools & Execution

- Toolchain Overview: https://topaz.ooo/v5.20/en/docs/toolchain/overview
- CLI & Diagnostics: https://topaz.ooo/v5.20/en/docs/toolchain/cli
- Interpreter & Backends: https://topaz.ooo/v5.20/en/docs/toolchain/backends

### Build & Delivery

- Artifacts & Deployment: https://topaz.ooo/v5.20/en/docs/toolchain/artifacts-deployment
- WASM & Playground: https://topaz.ooo/v5.20/en/docs/toolchain/wasm-playground
- Packages & Distribution: https://topaz.ooo/v5.20/en/docs/toolchain/packages
- Toolchain Status: https://topaz.ooo/v5.20/en/docs/toolchain/status

### Interop

- Interop Boundaries: https://topaz.ooo/v5.20/en/docs/interop/overview
- Rust Backend: https://topaz.ooo/v5.20/en/docs/interop/rust
- Python Backend: https://topaz.ooo/v5.20/en/docs/interop/python
- Lispex Evaluator and LIT: https://topaz.ooo/v5.20/en/docs/interop/lit
- Lena Code Interop: https://topaz.ooo/v5.20/en/docs/interop/lena-code
- AI Agents and MCP: https://topaz.ooo/v5.20/en/docs/interop/ai-agents

### Compatibility

- Language and Compatibility: https://topaz.ooo/v5.20/en/docs/project/conformance
- Legacy Syntax Migration: https://topaz.ooo/v5.20/en/docs/migration/from-pre-v5
- Classic: https://topaz.ooo/v5.20/en/docs/project/archive

## Other current surfaces

- Assistant primer: https://topaz.ooo/agents.md
- Full Markdown manual: https://topaz.ooo/llms-full.txt
- Per-page Markdown: append .md to a current English documentation slug under https://topaz.ooo/docs/
- Localized manuals: /v5.20/en/, /v5.20/ko/, /v5.20/ru/
- Playground: https://topaz.ooo/playground
- Toolchain status: https://topaz.ooo/v5.20/en/docs/toolchain/status
- Classic: https://topaz.ooo/v5.20/en/docs/project/archive
- Install: curl -fsSL https://topaz.ooo/install.sh | sh

Classic pages are intentionally separate from the current-manual search corpus.