polyshDocumentación / guía práctica
Convierte una grabación de pantalla en una guía paso a paso.
Usa la misma grabación para crear un tutorial fácil de leer. Empieza por la tarea, revisa el texto y haz que cada paso termine en algo que el lector pueda comprobar.
Empieza con una tarea completa.
Una buena guía tiene un punto de partida claro y un resultado visible. “Invitar a un compañero” le da al lector una tarea que completar. “Un recorrido por nuestra configuración” le da una colección de pantallas sin un motivo para usarlas.
Antes de grabar, anota para quién es la guía, qué permiso necesita esa persona y qué debería ver al terminar. Ten esas respuestas a mano mientras grabas el flujo de trabajo.
Revisa la narración antes de generar la guía.
Al hablar, una tarea se explica de forma distinta que en unas instrucciones escritas. Puede incluir un comentario al margen, una corrección o una referencia como “haz clic en ese”. Tu guion revisado debe nombrar los controles y explicar la acción en orden.
En Polysh, corrige los nombres de producto y las etiquetas de los botones antes de generar la guía. Conserva el contexto útil, pero sepáralo de las acciones que el lector realmente tiene que hacer.
Comprueba la acción, la captura y el resultado.
Polysh convierte la narración revisada en pasos agrupados, requisitos previos, notas y resultados esperados. Trata la guía generada como un borrador que hay que revisar.
- Acción: ¿el paso dice qué hacer usando el nombre del control visible?
- Captura: ¿muestra la pantalla que el lector necesita en ese momento?
- Resultado: ¿puede el lector saber si la acción funcionó?
Un paso con la captura equivocada confunde. Si la guía generada no tiene una imagen adecuada, elige entre las candidatas capturadas o déjala fuera hasta tener la correcta. Revisa la información sensible antes de compartir.