Manual de operación
El manual de la plataforma
Cómo un alumno convierte una función de Python en un servicio invocable, sobre el servidor de un centro que ya sostiene servicios en producción. Y qué hace, y qué no hace, la plataforma que lo permite.
Por dónde empezar, según a qué vengas
Seis entradas distintas al mismo manual. Ninguna exige leer las otras primero.
Una función, un archivo y nada más. Qué recibe, qué devuelve, qué tiene que viajar con tu entrega y cómo comprobarlo antes de darla. Es la única página escrita para ti.
Sigue una publicación entera, de la carpeta que entrega un alumno a la dirección que responde. Después, las seis vistas, en el orden en que se usan.
Empieza por lo que NO hace. Los cuatro límites están declarados y no se aplican, y hay dos decisiones abiertas que conviene conocer antes de instalar nada.
Cuatro pasos, qué sobrevive a un reinicio y qué no, y cómo comprobar que está viva sin abrir la pantalla.
Una página por pantalla, con su captura real y una tabla que explica cada elemento numerado sobre la imagen.
Los diez rechazos posibles, qué significa cada uno y qué hay que cambiar. Con los dos casos en los que la plataforma no da diagnóstico, y por qué.
Cómo está construida cada página
Las cuatro partes van siempre en este orden. Quien ha leído una página sabe leer todas.
Objetivo principal
Una frase que dice para qué sirve esa pantalla. Si no cabe en una frase, la página está describiendo dos cosas.
Mapeo de interfaz
Una captura real de la plataforma en marcha, con los elementos señalados por números pintados en la propia imagen.
Despiece de elementos
Una fila por número: qué es, de qué tipo, a dónde lleva o qué dispara, y qué hace. Cada número de la imagen tiene su fila.
Guía de uso
Cuándo se usa, qué esperar y qué NO hace. Aquí es donde se dice lo que la pantalla no puede resolver.
Dos cosas que este manual se toma en serio
Se toman de la plataforma desplegada de verdad, con un aula publicada, no de maquetas. Es lo que permite que una página afirme lo que afirma. Cuando una pantalla no está fotografiada, la página lo dice en lugar de dejar un hueco.
Este proyecto tiene decisiones aplazadas con nombre propio. Presentarlas como resueltas sería más cómodo y sería mentira. Aparecen donde afectan, y en el glosario están todas juntas.