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… 
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 
- Copier le référentiel Rgaa30 + renommage des répertoires, des fichiers, …
- Ajouter le nouveau référentiel au projet, à la webapp, au runner et au plugin Jenkins
- 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 
intéressant quand les modifications ne sont pas trop importantes.
Inconvénient 
- 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
- Produire un .csv du nouveau référentiel à partir du site officiel
- Générer un nouveau référentiel à partir du .csv via le plugin maven dédié.
- Ajouter le nouveau référentiel au projet, à la webapp, au runner et au plugin Jenkins.
- importer les tests identiques avec le même numéro
- importer les tests identiques avec changement de numéro
- ajouter les tests modifiés (analyse + modifications du code)
- 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
- 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
- processus plus laborieux
Le choix : A ou B ? 
Des variantes sont possibles pour l’option A, comme pour l’option B.
Un mix des 2 méthodes est aussi possible… 
Dans un but purement “didactique” nous allons suivre
l’option B “Ajouter un nouveau référentiel”
La cuisine vous est ouverte… 
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. 
À venir… 
- Coulisse 3) Ajouter le référentiel à la webapp, au runner et au plugin Jenkins
- Coulisse 4) Produire le .csv d’import du nouveau référentiel RGAA 3.2016
