Utiliza esta lista de verificación antes de publicar cualquier artículo para verificar que cumple con los estándares tanto de legibilidad humana como de recuperación por IA. Cada elemento se ajusta a una buena práctica cubierta en contenido compatible con Gen AI.
Estructura y encabezados
- Los encabezados H1, H2 y H3 se usan jerárquicamente, no se omiten niveles.
- Cada encabezado es descriptivo y específico, no genérico (evita "Resumen", "Introducción", "Detalles").
- No se repite ningún encabezado dentro del mismo artículo.
- Las palabras clave relevantes aparecen de forma natural en los encabezados.
Párrafos y flujo
- Las frases son cortas. Idealmente menos de 20 palabras y directo.
- Cada párrafo cubre una idea o tarea concreta.
- El relleno, el contexto de fondo y la información tangencial se eliminan o se enlazan por separado.
- Cada sección es modular y concisa. Idealmente menos de 500 fichas (~375 palabras).
Listas y tablas
- Los puntos clave se utilizan para información agrupada y no ordenada.
- Las listas numeradas se utilizan para pasos secuenciales.
- Las listas contienen de 3 a 7 elementos y cada uno es paralelo en estructura.
- Las tablas se utilizan para datos estructurados (parámetros, configuraciones, comparaciones).
- Todas las columnas de la tabla tienen encabezados descriptivos.
- Todas las celdas de la tabla contienen texto descriptivo. No hay Y/N, guiones, emojis ni iconos.
- No hay celdas fusionadas ni formato de tabla inconsistente.
Fragmentos de código
- El código está limpio, consistentemente indentado y correctamente formateado.
- Los comentarios en línea explican la lógica y la intención.
- Se aplican resaltados de sintaxis o etiquetas de idioma.
- Los bloques de código son copiables. Sin números de línea ni estilo decorativo.
- Se incluye una sentencia de contexto para código API o producto.
Imágenes y enlaces
- Cada imagen tiene un texto alternativo significativo y descriptivo.
- El texto alternativo evita etiquetas vagas como "captura de pantalla".
- Los pies de foto o el texto circundante aportan contexto adicional cuando es necesario.
- Todo el texto ancla es descriptivo. Por ejemplo, "Aprende a gestionar espacios de trabajo privados" en lugar de "aquí", "esto" o "haz clic aquí".
- Los enlaces internos enlazan con artículos relacionados cuando sea relevante.
SEO y metadatos
- Las palabras clave aparecen de forma natural en los encabezados, los aperturas de sección y el texto clave del cuerpo.
- Se redacta una metadescripción con las palabras clave principales del artículo.
- Se aplican metadatos estructurados (etiqueta de título, descripción, campos personalizados) cuando se soporta.
- La terminología es coherente con términos aprobados por glosarios.
Habilidades y flujo de trabajo de IA
- Si se utilizó un SKILL.md, el resultado ha sido revisado para comprobar su exactitud y completitud antes de publicarlo.
- No se saltaban secciones sin motivo. Si se omite una sección, realmente no es aplicable.
- La voz y el tono coinciden con las convenciones del MSTP: segunda persona, presente, voz activa, sin lenguaje de marketing.
- Las preguntas frecuentes producidas por la habilidad son autónomas y provienen de preguntas reales de usuarios, no de relleno generado.
GEO (Optimización de Motores Generativos)
- El artículo comienza con una respuesta directa a la pregunta principal del usuario en las dos primeras frases.
- Cada sección es autónoma y tiene sentido cuando se lee de forma aislada, sin necesidad de contexto circundante.
- Los términos clave y definiciones se expresan explícitamente, no se dan por hecho a partir del contexto.
- No hay información crítica enterrada en medio de un párrafo largo — ponla en un encabezado, lista o indicación.
- El contenido está estructurado para que la IA pueda extraer una respuesta útil sin necesidad de leer el artículo completo.
Glosario y terminología
- Los términos aprobados del glosario se utilizan exactamente como se definen. Sin sinónimos ni variaciones.
- Términos desconocidos se definen o enlazan a la primera.
- Las abreviaturas y acrónimos se utilizan de forma constante a lo largo de todo el libro.
Estilo de escritura
- El tono es claro, conversacional y fácil de usar.
- Se utiliza lenguaje sencillo; Se evita o se explica la jerga.
- La segunda persona ("tú") se utiliza en contenidos didácticos y prácticos.
Preguntas frecuentes
- El artículo incluye entre 5 y 10 preguntas frecuentes en una sección dedicada.
- Las preguntas provienen de consultas reales de usuarios, tickets de soporte o preguntas comunes sobre productos.
- Cada respuesta a preguntas frecuentes es autónoma y concisa.
Comprobaciones específicas de IA
- Borradores generados por IA revisados para su precisión, tono y alucinaciones.
- El artículo ha sido probado en Eddy AI para confirmar respuestas precisas.
- El contenido es lo suficientemente modular como para reutilizarse en preguntas frecuentes, respuestas en chat y resúmenes.
- Se han revisado e incorporado las consultas sin respuesta o los comentarios de soporte.