Frames
Un frame (el encuadre) es un Blueprint (plano) que describe el producto entero en lugar de una unidad de él: a quién sirve, qué intenta lograr, cómo está construido. Todos los demás Blueprints se juzgan contra ellos. Los frames viven en una colección de encuadre, una colección como cualquier otra, cuyos templates (plantillas) se llaman frame.<variant>.md.
El estándar no exige una. Cada semilla abre con una, eidos install la incluye salvo que pases --no-framing, y Eidos recomienda una para todo producto.
Por qué
Sección titulada «Por qu黫¿Debería existir esta spec?» no tiene respuesta a menos que algo diga ya a quién sirve el producto y para qué es. Sin frames, una raíz se convierte en una pila de Blueprints razonables cada uno por su cuenta y sin dirección común.
Qué encuadran las semillas
Sección titulada «Qué encuadran las semillas»| Semilla | Sus frames |
|---|---|
software |
architecture · audience · criteria · market |
book |
premise · reader · voice · market |
research |
question · prior work · method · ethics |
No son las mismas cuatro ideas con otro nombre. La investigación necesita encuadrar la ética; un libro necesita la voz. Encuadra aquello contra lo que tu trabajo se juzga de verdad, sean tres cosas o seis.
Cómo es un frame
Sección titulada «Cómo es un frame»Cada tipo de frame es su propia variant (variante). De la semilla software:
# {{title}}
## Shape
## Components
## Data and flow
## Boundaries and dependenciesProsa suelta bajo encabezados estables, que registra lo que es cierto ahora y se revisa cada vez que ese juicio cambia. Los frames están planos en su colección, un archivo por tipo.
Los frames son Blueprints, no documentos de nivel superior
Sección titulada «Los frames son Blueprints, no documentos de nivel superior»Ambos son prosa suelta revisada en el sitio. La diferencia es la repetición: un frame sigue un template, lleva el contrato de propiedades y se valida, porque hay uno por tipo. Un documento de nivel superior se escribe una vez y no recibe nada de eso.
Rellénalos primero
Sección titulada «Rellénalos primero»La manera más común de hacer mal Eidos es saltarse los frames, porque los Blueprints parecen progreso y los frames parecen preámbulo. Rellenarlos lleva una tarde, la mayor parte discusión, y la discusión es el valor: descubres que dos personas construían hacia audiencias distintas antes de que ninguna escribiera una spec que diera una por supuesta.
Un frame declarado y sin escribir es un hueco que eidos check muestra, nunca un fallo.