Ispezionatore della Documentazione AWS

L'ispezione valuta la documentazione AWS dei servizi per accuratezza, completezza e coerenza. Accetta input quali service_name, doc_version, region e doc_source_url e applica una suite di controlli di qualità basati su riferimenti pubblici AWS e note di rilascio. Gli utenti target sono sviluppatori API, redattori tecnici e team di governance che devono assicurarsi che i riferimenti ai servizi restino allineati durante le versioni rapide.
Controlli principali includono allineamento terminologico, coerenza dei nomi dei parametri, tipi di dati e unità, presenza di sezioni obbligatorie e validazione dei link incrociati alle pagine di riferimento AWS. I report di diff tra versioni evidenziano aggiunte o rimozioni tra versioni. Il punteggio è deterministico per i controlli principali; punteggio ML opzionale valuta leggibilità e deriva terminologica.
Flusso di lavoro: fornire input, scegliere l’ambito di analisi (core vs avanzato), eseguire l’analisi, rivedere il rapporto strutturato ed esportare JSON o Markdown. Le uscite includono un elenco di riscontri, suggerimenti di remediation, un punteggio di conformità e un riepilogo delle modifiche. Priorità a problemi ad alto impatto: definizioni di parametri ambigue e note di sicurezza mancanti. Pubblico: product manager, sviluppatori API e redattori tecnici che necessitano di qualità documentale riproducibile e auditabile. Differenziatori: coerenza tra servizi basata sulla versione, log di audit esportabili e mappatura diretta ai documenti canonical AWS. Focus su logica di dominio e output azionabili, senza UI/UX.