Estructura de l'informe: resum executiu, metodologia, resultats per criteri i evidències

L'informe és el producte de l'auditoria. El llegiran persones amb interessos diferents: una directora que vol saber si compleix i quant costarà arreglar-ho, un responsable d'accessibilitat que ha de redactar la declaració, desenvolupadors que necessiten reproduir cada error i editors que han de canviar hàbits. Un bon informe atén tothom sense obligar ningú a llegir-lo sencer. Aquesta lliçó proposa una estructura provada i detalla què va a cada part.

Principis d'un bon informe

• Traçable: qualsevol afirmació remet a una pàgina, un criteri i una evidència. Segueix els cinc passos de WCAG-EM (s'obre en una finestra nova) perquè el lector sàpiga què es va avaluar i com.
• Accionable: cada troballa indica què cal fer, amb la tècnica concreta i, si és possible, codi.
• Proporcionat: separa el que incompleix el nivell objectiu del que és recomanació; agrupa el que es repeteix; no infla el recompte d'errors.
• Accessible: l'informe es lliura en format accessible (HTML, o document amb estructura, alt i taules correctes; si és PDF, etiquetat). Un informe d'accessibilitat inaccessible perd tota l'autoritat.
• Honest sobre els seus límits: una mostra és una mostra; l'informe ho diu, i evita expressions com «certifiquem» o «garantim».

Estructura recomanada

El resum executiu

És l'única part que llegirà la direcció, així que ha de cabre en una o dues pàgines i respondre cinc preguntes: compleix? (estat: no conforme, parcialment conforme o plenament conforme, amb l'aclariment que es basa en una mostra); quant falla? (nombre de criteris incomplerts sobre el total avaluat i nombre de troballes per severitat); què és el més greu? (de tres a cinc barreres descrites en termes de persones i tasques: «una persona cega no pot completar la sol·licitud de cita perquè el calendari no és operable amb teclat ni lector»); què cal fer primer?; quines implicacions legals té? (obligacions del RD 1112/2018 (PDF, s'obre en una finestra nova) o de la Llei 11/2023 (PDF, s'obre en una finestra nova) segons el tipus d'entitat, sense alarmisme ni assessorament jurídic que no et correspongui).

Resultats per criteri

La taula de criteris és el pont entre l'auditoria i la declaració d'accessibilitat: llista els 55 criteris A i AA de WCAG 2.2 (31 de nivell A i 24 de nivell AA, un cop eliminat el 4.1.1) amb número, nom, nivell i veredicte global: compleix (a totes les pàgines aplicables), no compleix (almenys a una), no s'aplica (cap pàgina té contingut afectat) o no es pot determinar (no va ser possible concloure-ho i s'explica per què). Afegeix-hi una columna amb els identificadors de les troballes relacionades i, si l'informe ho permet, la matriu criteri × pàgina. També convé afegir-hi el requisit equivalent de l'EN 301 549 (PDF, s'obre en una finestra nova), com veuràs a la lliçó «Del criteri WCAG al requisit de la norma». Aquesta taula és el que el responsable farà servir per emplenar la secció «contingut no accessible» de la declaració, criteri a criteri.

Les troballes

Cada troballa és una fitxa autònoma, amb l'estructura vista al curs N4-C3: identificador, títol descriptiu («El calendari de cita prèvia no és operable amb teclat»), criteri principal i secundaris amb número i nom, severitat, pàgines i estats afectats (indicant si és de plantilla o de contingut), descripció, passos per reproduir-la, resultat esperat i observat, combinació de prova, evidències i recomanació amb codi. Agrupa les troballes per component o plantilla sempre que sigui possible, no per pàgina: «capçalera», «formularis», «fitxes de tràmit», «procés de pagament». Així l'equip de desenvolupament veu la feina tal com és: arreglar sis components, no 64 pàgines. Com redactar cada part de la fitxa perquè es corregeixi a la primera és el tema de la lliçó següent.

Recomanacions i annexos

La secció de recomanacions recull el que no incompleix el nivell objectiu però convé millorar: criteris AAA de baix cost, bones pràctiques de les eines (landmarks, un únic h1), usabilitat detectada amb les tecnologies de suport, alineació amb l'EN 301 549 més enllà de WCAG si escau. Cadascuna porta el seu propi identificador (R-01) perquè ningú no la confongui amb un incompliment. Als annexos van les sortides en brut de les eines, el full de troballes en format importable (CSV o XLSX), un glossari breu (nom accessible, landmark, regió viva…) i les referències normatives amb enllaços oficials.

Format i accessibilitat de l'informe

Lliura l'informe en un format accessible i, si pot ser, en dos: un document estructurat (HTML o Word accessible, PDF etiquetat si s'exigeix) i el full de troballes. Comprova el mateix informe: estils de títol reals, taules amb encapçalaments, alt a les captures (descrivint què mostra la captura, no «captura de pantalla»), contrast dels colors de severitat acompanyats de text, enllaços descriptius. Si l'informe inclou vídeos, acompanya'ls d'una descripció textual.

Resum

• L'informe ha de ser traçable (WCAG-EM), accionable, proporcionat, accessible i honest sobre els seus límits.
• Estructura: dades, resum executiu, abast i metodologia, mostra, resultats per criteri, troballes, recomanacions, pla de correcció i annexos.
• El resum executiu respon en dues pàgines si compleix, quant falla, què és el més greu, què cal fer primer i què implica legalment.
• La taula dels 55 criteris A i AA amb el seu veredicte és la base de la declaració d'accessibilitat.
• Una troballa és un problema (amb les seves instàncies), agrupada per component, amb criteri, evidència, severitat i recomanació; les recomanacions van a part.