Contexto

Por qué DON

DON se diseñó para escribir anotaciones de infraestructura (rutas, contenedores, reglas de seguridad, proxies inversos) en una forma rápida de leer y de generar, tanto para personas como para agentes de IA. En lugar de anidar claves, una directiva recibe sus parámetros como argumentos posicionales: una regla con método, ruta y cuerpo ocupa una línea en vez de un árbol.

route GET /api {
  respond 200 "Ok"
}

El equivalente en un formato clave-valor necesita un nivel de anidación por parámetro:

routes:
  /api:
    GET:
      respond: 200 Ok

Como la forma es uniforme (nombre arg1 arg2 { hijos }), quien lee o escribe DON no necesita seguir reglas de indentación para saber qué significa una declaración: lee los argumentos en orden.

Comparación

A diferencia de los DSL atados a un dominio, DON no trae esquema integrado y sirve para cualquier dominio.

Lenguaje Dominio Argumentos posicionales Claves repetidas en un nivel Propósito general
DON Configuración, anotaciones de infraestructura, rutasSíSíSí
Nginx Servidor HTTP / proxy inversoSíSíNo (solo HTTP)
Caddyfile Servidor HTTP / proxy inversoSíSíNo (solo HTTP)
HCL (Terraform) Infraestructura como códigoParcial (etiquetas)Sí (etiquetas)No (solo IaC)
YAML Serialización de datosNoNo (requiere listas)Sí
JSON Serialización de datosNoNo (requiere listas)Sí
Dockerfile Construcción de imágenesSíSíNo (solo builds)

Un ejemplo grande: OpenAPI

El repositorio incluye una API "Pet Store" descrita como documento OpenAPI 3.0 en JSON y como un documento DON equivalente, con cada propiedad (info, servers, parámetros, cuerpos, respuestas y esquemas) mapeada a una directiva. Un fragmento:

route GET /pets/{petId} {
  summary "Get a pet by id"
  operationId getPetById
  param petId {
    in path
    required true
    schema {
      type integer
      format int64
    }
  }
  response 200 {
    description "The requested pet"
    content application/json {
      schema ref Pet
    }
  }
}

Los dos archivos completos y la tabla de correspondencia están en docs/examples/pet-store-openapi.