Skip to content

VIS-005: Onboarding, demo y troubleshooting en la landing - #20

Merged
ChristianM023 merged 5 commits into
mainfrom
docs/vis-005-onboarding-demo
Aug 23, 2026
Merged

ChristianM023 merged 5 commits into
mainfrom
docs/vis-005-onboarding-demo

Conversation

@ChristianM023

Copy link
Copy Markdown
Owner

VIS-005 — Crear onboarding y demo de activación

Añade onboarding en la landing (EN/ES) para que el usuario que llega por primera vez vea el producto en acción rápidamente.

Cambios

  • Quick test / Prueba rápida (sección 08): comando de prueba destacado (notify-sound --daemon + notify-send).
  • Demo (sección 02): video demo.mp4 (17s, 2.7MB) grabado con OBS, integrado con <video controls autoplay loop muted playsinline> + caption. Muestra una notificación silenciosa sin NotifySound y la misma con sonido al activarlo, con el medidor de volumen de OBS visible.
  • Troubleshooting / Solución de problemas (sección 09): 4 puntos condensados + enlace al README.
  • Reordenamiento: Demo (02) y Screenshots (03) movidas arriba, justo después de The problem, para mostrar el producto en acción sin scrollear 7 secciones.
  • site/demo/README.md: registro del demo (qué es, qué muestra, cómo se grabó, formato).
  • site/style.css: clases .demo-video y .demo-caption.

Detalles

  • Fix de ruta del video en la landing ES (../demo/demo.mp4 en lugar de demo/demo.mp4).
  • Terminología "no repetir" unificada con el microcopy de la GUI en la landing ES.
  • Enlace de troubleshooting ES apunta a README.es.md#solución-de-problemas.
  • Comando de prueba traducido al español en la landing ES.

Verificación

  • scripts/quality.sh — OK (py_compile sobre 6 módulos).
  • scripts/test-all.sh — 89 tests OK.
  • session-review — OK.

Ticket VIS-005 completado. Detalle en spec/constitution/changelog.md (privado).

Añade secciones de Quick test/Prueba rápida con comando de prueba
destacado, Troubleshooting/Solución de problemas condensada (4 puntos
+ enlace al README), y sección Demo con placeholder para el material
audiovisual que el operador grabará después. Crea site/demo/README.md
con instrucciones de grabación.

Parte de VIS-005 (Fase 0 — Activación). El ticket queda en curso [~]
hasta que el operador proporcione el GIF/video y las capturas actualizadas.
Resuelve W1 del session-review: el archivo no terminaba con
newline (violación Tier 1.4 — formato LF).
Reemplaza el placeholder de la sección Demo con el video demo.mp4
(17s, 2.7MB) grabado por el operador con OBS. Muestra una notificación
silenciosa sin NotifySound y la misma notificación con sonido al
activar NotifySound, con el medidor de volumen de OBS visible.

El video usa controls+autoplay+loop+muted+playsinline para permitir
autoplay en navegadores modernos; el usuario activa el sonido manualmente.

Actualiza site/demo/README.md como registro del demo (qué es, qué
muestra, cómo se grabó, formato).

Completa los criterios de demo audiovisual y capturas actualizadas de
VIS-005 (Fase 0 — Activación).
El <source> del video usaba src="demo/demo.mp4" que desde site/es/
resolvía a site/es/demo/demo.mp4 (inexistente). Cambiado a
src="../demo/demo.mp4" para seguir el patrón ../ de los demás
assets de la landing ES (style.css, screenshots, qr).
Las secciones Demo y Screenshots estaban en las posiciones 07 y 08,
demasiado abajo — el usuario tenía que scrollear 7 secciones para ver
el producto en acción. Movidas a 02 y 03, justo después de The problem,
para que el usuario vea el problema y luego inmediatamente la solución
en acción (video + capturas).

Renumeración de secciones 01-10 en ambos archivos (EN y ES).
@ChristianM023
ChristianM023 merged commit 207148f into main Aug 23, 2026
1 check passed
@ChristianM023
ChristianM023 deleted the docs/vis-005-onboarding-demo branch August 23, 2026 01:05
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant