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, rutas | Sí | Sí | Sí |
| Nginx | Servidor HTTP / proxy inverso | Sí | Sí | No (solo HTTP) |
| Caddyfile | Servidor HTTP / proxy inverso | Sí | Sí | No (solo HTTP) |
| HCL (Terraform) | Infraestructura como código | Parcial (etiquetas) | Sí (etiquetas) | No (solo IaC) |
| YAML | Serialización de datos | No | No (requiere listas) | Sí |
| JSON | Serialización de datos | No | No (requiere listas) | Sí |
| Dockerfile | Construcción de imágenes | Sí | Sí | No (solo builds) |
- Nginx y Caddyfile son lo más parecido (directiva, argumentos posicionales y bloques), pero están atados a HTTP.
- YAML y JSON necesitan un nivel extra por parámetro y listas para repetir una clave.
- HCL admite etiquetas posicionales en un bloque, pero dentro usa atributos clave-valor.
- Dockerfile es una secuencia plana de instrucciones; DON añade bloques anidados a ese modelo.
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.