Coulisse 2) ajouter le RGAA 3 2016 : comment faire?

Sommaire | Précédent | Suivant


La série Coulisse est l’occasion de rendre public
le processus d’ajout d’un référentiel « officiel » à Asqatasun.

Après l’introduction culinaire, passons aux choix des recettes:cake:

2 possibilités pour intégrer le Rgaa3 2016 à Asqatasun

  • A. Copier le RGAA 3.0 et appliquer les modifications du changelog
  • B. Créer un nouveau référentiel et importer l’existant à partir du RGAA 3.0

Dans les 2 cas il faudra utiliser le changelog pour identifier :

  • les tests identiques avec le même numéro
  • les tests identiques avec changement de numéro
  • les tests modifiés avec le même numéro

A. Copier le RGAA 3.0 et appliquer les modifications du changelog

Processus :clipboard:

  1. Copier le référentiel Rgaa30 + renommage des répertoires, des fichiers, …
  2. Ajouter le nouveau référentiel au projet, à la webapp, au runner et au plugin Jenkins
  3. Modifier à partir du changelog
    • changement de numéro
    • supprimer les tests Rgaa obsolètes
    • ajouter les nouveaux tests Rgaa
    • modifier les tests Rgaa évoluant

Avantage :green_book:

intéressant quand les modifications ne sont pas trop importantes.

Inconvénient :closed_book:

  • il vaut mieux attendre que tout le changelog soit traiter avant d’utiliser ce nouveau référentiel
  • seule la rigueur des développeurs à suivre le changelog permet de garantir que toutes les modifications nécessaires ont bien été appliquées au référentiel qui a servie de source.

B. Créer un nouveau référentiel et importer à partir du RGAA 3.0

Processus :clipboard:

  1. Produire un .csv du nouveau référentiel à partir du site officiel
  2. Générer un nouveau référentiel à partir du .csv via le plugin maven dédié.
  3. Ajouter le nouveau référentiel au projet, à la webapp, au runner et au plugin Jenkins.
  4. importer les tests identiques avec le même numéro
  5. importer les tests identiques avec changement de numéro
  6. ajouter les tests modifiés (analyse + modifications du code)
  7. ajouter les nouveaux tests quand Asqatasun peut les traiter

À l’étape 3, dans Asqatasun, le nouveau référentiel est bien présent mais tous les tests du Rgaa 3.2016 sont identifiés comme non implanté dans la webapp.

Les étapes 4 et 5 d’import de l’existant est automatisable.

Pour les étapes 6 et 7, l’analyse pour identifier ce qu’Asqatasun peut traiter et la création de testCases (portion de HTML permettant de vérifier si le l’implantation est correcte) devra être réalisé par des contributeurs spécialistes de l’accessibilité.

Avantage :green_book:

  • processus plus rigoureux
  • à partir de l’étape 3, le référentiel Rgaa 3.2016 sera toujours correctement implanté (par de scorie d’un existant) et sa couverture du référentiel évoluera à chaque nouvel étape et test implanté.
  • utiliser le process existant d’ajout d’un référentiel dans Asqatasun
    et en profiter pour améliorer la documentation

Inconvénient :closed_book:

  • processus plus laborieux

Le choix : A ou B ? :motorcycle:

Des variantes sont possibles pour l’option A, comme pour l’option B.
Un mix des 2 méthodes est aussi possible… :sunglasses:

Dans un but purement “didactique” nous allons suivre
l’option B “Ajouter un nouveau référentiel” :green_book:

La cuisine vous est ouverte… :gift:

Cette série Coulisse est l’occasion de rendre public le processus d’ajout d’un référentiel « officiel » à Asqatasun à la fois pour le documenter et pour le rendre accessible à tous.

Vos retours, questions, remarques et contributions
sont les bienvenus et même fortement recommandés. :wink:

À venir… :alarm_clock:


Sommaire | Précédent | Suivant

2 Likes

cette étape est-elle identique aux 2 méthodes ?

oui @Wipu cette étape est bien identique pour :

  • la copie d’un référentiel existant
  • la création d’un nouveau référentiel

La série coulisse va pouvoir continuer
car les 3 premières étapes de “création d’un nouveau référentiel”
sont maintenant faites et testées.

la preuve en image… :checkered_flag:

Lancer un audit RGAA 3 2016

Afficher le résultat de l’audit

Afficher les tests “Non testé”

La 3ème partie est en ligne : :books:
Ajouter le référentiel à la webapp, au runner et au plugin Jenkins

La 4ème partie est en ligne : :books:
Produire le .csv d’import du nouveau référentiel RGAA 3.2016