El manifiesto de Sintaxis del Oficio
Pequeños lenguajes para oficios reales.
Las personas utilizan lenguajes específicos de dominio a diario. «Latte desnatado con caramelo» funciona porque cliente y barista comparten el contexto. Un lenguaje informático útil puede capturar ese mismo conocimiento de trabajo.
Sintaxis del Oficio explora el vocabulario vivo de un oficio: sus palabras, distinciones, valores predeterminados y hábitos. Un buen lenguaje de dominio debe sonar como algo propio de quienes lo utilizan.
01 / Principio
Empieza por el lenguaje de trabajo.
El primer deber de un lenguaje de dominio es escuchar. Debe empezar por el lenguaje que ya utilizan guionistas, dibujantes, ingenieros, diseñadores y otros profesionales, no por la comodidad de quien lo implementa.
02 / Principio
Nombra distinciones reales.
Un lenguaje nombra bien las cosas cuando conserva las distinciones que importan en la práctica: página y viñeta, lugar y acción, activo y amenaza, componente y conexión.
03 / Principio
Mantén legible el código fuente.
El código fuente debe permanecer cerca de la forma de pensar. Debería poder leerse con gusto y entenderse su intención sin descifrar maquinaria.
04 / Principio
Oculta la maquinaria.
TeX, analizadores, bases de datos y generadores son herramientas, no el tema. Los mecanismos internos deben apoyar el lenguaje, no dominarlo.
05 / Principio
Usa los valores predeterminados con inteligencia.
Un pequeño lenguaje se vuelve humano cuando hace suposiciones sensatas, de modo que una entrada breve pueda producir un resultado útil.
06 / Principio
Permite precisar sin amontonar detalles.
Un lenguaje debe ser breve en el caso habitual y más exacto solo cuando lo exija el trabajo.
07 / Principio
Da significado a la estructura.
La estructura es valiosa porque permite comprobar, comparar, transformar y reutilizar el significado, no por ser formal.
08 / Principio
Deja que las herramientas detecten incoherencias.
Un compilador debe detectar pronto referencias rotas, estados ausentes y combinaciones imposibles, antes de que se conviertan en errores caros.
09 / Principio
Permite trabajar en borrador y en modo estricto.
El trabajo inicial debe tolerar lo incompleto. El trabajo terminado debe exigir coherencia.
10 / Principio
Genera más de una vista.
Una fuente debe poder producir muchas formas útiles: prosa, diagramas, tablas, fichas, páginas web, PDF o informes.
11 / Principio
Respeta el oficio.
Un lenguaje de dominio debe hacer más visible su oficio, no reducirlo a burocracia. Su propósito es ayudar al criterio, no sustituirlo.
12 / Principio
Construye pequeños lenguajes con cuidado.
Un pequeño lenguaje es una pieza de carpintería intelectual: modesta en escala, precisa en sus uniones y mejor juzgada por lo naturalmente que encaja con el trabajo.