JsonDispatch – Developer Guide
==============================

Welcome! This site hosts the **JsonDispatch** specification and examples.

- **What is it?** A lightweight, production-ready JSON response spec.
- **Why use it?** Stable envelope (``success`` / ``fail`` / ``error``), server-generated tracing with
  ``X-Request-Id`` and clear version signaling via request ``X-Api-Version`` and response
  ``X-Api-Version-Selected``.

.. toctree::
   :maxdepth: 2
   :caption: Contents

   spec/01-introduction
   spec/02-media-types-versioning
   spec/03-identification
   spec/04-envelope
   spec/05-examples
   spec/06-error-handling
   spec/07-properties-references
   spec/08-links
   spec/09-compatibility
   spec/10-best-practices
   spec/11-appendix