60 lines
2.1 KiB
Markdown
60 lines
2.1 KiB
Markdown
|
# Mini-demo — Working Group OntoRef
|
||
|
|
|
||
|
|
Dos opciones de mini-demo (~8-10 min) para la sesión de presentación. La
|
||
|
|
demo se ejecuta en vivo desde una terminal cuando las slides llegan a la
|
||
|
|
slide-anchor "Demo en vivo".
|
||
|
|
|
||
|
|
## Cuál usar
|
||
|
|
|
||
|
|
| Opción | Recomendada para | Complejidad |
|
||
|
|
|---|---|---|
|
||
|
|
| **A — Owner por servicio** | Audiencia mixta de developers (cualquier stack) | Baja, ~12 líneas |
|
||
|
|
| **B — Capas sin acople** | Audiencia rustacean / backend con experiencia | Media, ~30 líneas |
|
||
|
|
|
||
|
|
**Recomendación**: usar la opción A en la primera sesión. La opción B queda
|
||
|
|
guardada por si en alguna repetición del WG la audiencia exige más
|
||
|
|
sofisticación.
|
||
|
|
|
||
|
|
## Estructura de cada opción
|
||
|
|
|
||
|
|
Cada opción tiene tres archivos `.ncl` que representan los tres pasos de la
|
||
|
|
demo:
|
||
|
|
|
||
|
|
```text
|
||
|
|
option-X/
|
||
|
|
├── README.md Descripción de la opción
|
||
|
|
├── core.start.ncl Paso 1: archivo mínimo sin contrato
|
||
|
|
├── core.with-contract.ncl Paso 2: contrato añadido, nickel export pasa
|
||
|
|
└── core.broken.ncl Paso 3: violación, nickel export falla
|
||
|
|
```
|
||
|
|
|
||
|
|
El presentador no copia estos archivos durante la demo — los va escribiendo
|
||
|
|
en vivo. Los archivos sirven como:
|
||
|
|
|
||
|
|
- Referencia de lo que tiene que terminar escribiendo
|
||
|
|
- Plan B si se queda en blanco (`cp core.with-contract.ncl /tmp/demo-wg/core.ncl`)
|
||
|
|
- Material de grabación asciinema para Plan B audiovisual
|
||
|
|
|
||
|
|
## Ejecutar manualmente para ensayar
|
||
|
|
|
||
|
|
```bash
|
||
|
|
cd /tmp && rm -rf demo-wg && mkdir demo-wg && cd demo-wg
|
||
|
|
|
||
|
|
# Paso 1
|
||
|
|
cp /Users/Akasha/Development/ontoref/assets/work-group-ore/demo/option-a-owner/core.start.ncl ./core.ncl
|
||
|
|
nickel export core.ncl # exporta JSON
|
||
|
|
|
||
|
|
# Paso 2
|
||
|
|
cp /Users/Akasha/Development/ontoref/assets/work-group-ore/demo/option-a-owner/core.with-contract.ncl ./core.ncl
|
||
|
|
nickel export core.ncl # exporta JSON
|
||
|
|
|
||
|
|
# Paso 3
|
||
|
|
cp /Users/Akasha/Development/ontoref/assets/work-group-ore/demo/option-a-owner/core.broken.ncl ./core.ncl
|
||
|
|
nickel export core.ncl # falla con missing definition for 'owner'
|
||
|
|
```
|
||
|
|
|
||
|
|
## Plan B audiovisual
|
||
|
|
|
||
|
|
Ver `recording/README.md` para la grabación con asciinema y cómo reproducirla
|
||
|
|
si la demo en vivo falla.
|