Reference·Overview

Reference

Reference overview

The map of deeper and more exact materials. Most readers do not need to start with the full spec — this page tells you which document to read next based on what you care about.

Core references on this site

The three definitive long-form documents, all hosted here:

  • Blue Language Specification — the exact normative semantics of the language and the processing model. Use this when you need to know precisely how something behaves.
  • Technical white paper: Timelines — why ordering, completeness, and identity attribution work the way they do, and what trust assumptions follow.
  • PayNote reference — the standard contract for governing one transaction: lifecycle, participants, requests, responses, control locks, and worked examples.

Companion concept pages

Compact, hand-written explanations for each topic. Read these first if you want intuition before going to the spec.

Tutorials

Guided walk-throughs that build understanding step by step.

External companions

Material that lives outside this site:

Recommended reading orders

If you are new

  1. What is Blue?
  2. Your first world
  3. Blocks
  4. Build paths
  5. BlueId essentials
  6. Document stepper
  7. Tutorial

If you are technical and impatient

  1. What is Blue?
  2. Document stepper
  3. Raw Blue
  4. Language track
  5. Contracts track
  6. Specification

If you care about trust and identity

  1. Timelines
  2. Timeline providers
  3. Actors and trust
  4. Technical white paper: Timelines

If you care about payments

  1. PayNotes (concept)
  2. PayNote reference
  3. Composition
  4. paynotes.blue ↗
Without a guide, a documentation site full of good content can still feel intimidating. Use this page to make the docs feel like a system, not a pile.