Elysia Tools
Navegación
Workflow Playbook
Revisa una versión frente a su registro de cambios, valida la sintaxis y las referencias de Markdown y prepara notas coherentes para web, Slack y PDF.
Temas
Este recorrido sirve a responsables que entregan una versión de software a revisores y encargados de anuncios. Parte de un registro autorizado y de una versión concreta, no de mensajes de cambios mezclados. Extrae sus secciones, comprueba fechas y categorías y contrasta las entradas con pruebas aprobadas. Una sección vacía puede indicar un formato no reconocido; no demuestra ausencia de cambios. Evita incorporar todo lo pendiente de publicación.
Explica qué cambia, quién debe actuar y qué instrucciones de migración o reversión están aprobadas. SemVer válido no justifica un incremento menor. Resuelve esa decisión antes de publicar. El control de estilo localiza defectos de formato, pero las correcciones seguras no revisan la jerarquía de títulos ni la exactitud de ejemplos. Fija una revisión del original antes de producir variantes.
Un anuncio corto no suele necesitar índice. En documentos largos, termina los títulos antes de generarlo y comprueba referencias después. Las anclas siguen convenciones de GitHub; pruébalas en el renderizador del sitio. La comprobación estática no certifica que una descarga esté disponible. Abre los destinos externos necesarios y comprueba también los requisitos de acceso.
Prepara solo los formatos requeridos. Una tabla extensa puede quedar en las notas completas; para Slack utiliza un resumen legible que conserve las advertencias de migración y el enlace oficial. Reescribe tablas, listas de tareas o explicaciones dependientes de imágenes cuando se marquen como no compatibles. Convertir no equivale a desplegar ni a enviar mensajes.
Si se requiere PDF, revisa páginas reales para detectar tablas recortadas, código desbordado y contexto perdido en los saltos. Compara versión, fecha, instrucciones y enlaces de cada entrega con el original. Regenera las variantes antiguas en vez de corregir únicamente el archivo exportado. Registra revisión aprobada y nombres de archivos juntos. Para manuales amplios usa el flujo de documentación; para ajustes aislados, las utilidades de Markdown. La compatibilidad de contratos pertenece a la revisión de versiones de API previa a esta entrega.
Guía de flujo de trabajo
Extrae versiones y cambios clasificados, selecciona la publicación prevista, contrástala con las pruebas y valida el identificador sin confundir sintaxis con compatibilidad.
Corrige avisos de formato, revisa títulos y bloques de código manualmente y completa las explicaciones de cambios y migración.
Genera un índice solo si aporta valor; después revisa anclas internas, formatos y referencias sin definir. Prueba aparte los enlaces externos y las anclas del destino.
Convierte el original aprobado a HTML y el anuncio a Slack mrkdwn, adapta elementos no compatibles y compara hechos críticos antes de entregar, sin publicación automática.
SemVer comprueba solo la sintaxis. Decide la compatibilidad con pruebas de los cambios; revisa el versionado de API cuando cambien contratos.
Omítelo en anuncios breves. En notas largas, fija primero los títulos, genera la navegación y verifica las anclas en el destino.
Conserva el contexto en web o PDF. Acorta Slack sin eliminar avisos de migración ni el enlace oficial; adapta tablas y listas de tareas no compatibles.
Exporta un PDF con el tema adecuado, inspecciona paginación y legibilidad y compara las entregas necesarias con la misma revisión aprobada.