Inspector de la Documentación AWS

El inspector analiza la documentación de AWS a través de servicios, centrándose en precisión, exhaustividad y consistencia. Acepta entradas como service_name, doc_version, region y doc_source_url, y luego aplica una suite de controles de calidad contra referencias públicas de AWS y notas de versión. Los usuarios objetivo son desarrolladores API, redactores técnicos y equipos de gobernanza documental que deben garantizar que las referencias de servicio permanezcan alineadas durante lanzamientos rápidos.
Controles clave incluyen alineación terminológica, consistencia en nombres de parámetros, tipos de datos y unidades, presencia de secciones requeridas y validación de enlaces cruzados a páginas de referencia de AWS. Los informes de diferencias por versión destacan adiciones o eliminaciones entre versiones. La puntuación es determinista para controles centrales y puede usar puntuación ML opcional para legibilidad y deriva terminológica.
Flujo de trabajo: proporcionar entradas, elegir alcance de análisis (núcleo vs avanzado), ejecutar análisis, revisar informe estructurado y exportar JSON o Markdown. Salidas: una lista de hallazgos, sugerencias de remediación, una puntuación de conformidad y un resumen de cambios. Priorización de problemas de alto impacto como definiciones de parámetros ambiguas y notas de seguridad ausentes. Público: gerentes de producto, desarrolladores API y redactores técnicos que requieren calidad documental reproducible y auditables. Diferenciadores: consistencia entre servicios basada en versión, registros de auditoría exportables y mapeo directo a documentos canónicos de AWS. Enfoque en lógica de dominio y salidas accionables, sin interfaz de usuario.