Retraceur 4.0.0-beta3

Le 30 juillet, je pensais publier la première version candidate de Retraceur 4.0.0. Finalement, la rédaction de la documentation des nouvelles fonctionnalités de découverte et de mise à jour des extensions et des blocs m’a conduit à revoir ce calendrier.

En effet, mon travail de documentation, ce jour là, m’a permis d’identifier trois anomalies supplémentaires dont les correctifs méritent d’être bêta-testés avant d’envisager la publication de la version candidate.

Voilà pourquoi l’annonce de Retraceur 4.0.0-beta3 remplace aujourd’hui celle de la version candidate initialement prévue et nécessite de décaler la publication de la version 4.0.0 stable et définitive de quelques jours, vraisemblablement au 4 août.

La documentation fait aussi partie des tests

Le développement d’une fonctionnalité ne s’arrête pas lorsque le code compile ou que les premiers tests sont concluants.

Pour cette troisième bêta, c’est la rédaction de la documentation des nouvelles APIs de découverte et de mise à jour qui a permis de mettre en évidence plusieurs comportements qui ne correspondaient pas à ce que Retraceur devait proposer.

Cette expérience confirme, s’il le fallait encore, qu’une documentation n’est pas uniquement destinée à expliquer un logiciel : elle constitue également un excellent moyen de le valider.

Une interface plus aboutie

Au-delà de ces correctifs, cette troisième bêta apporte plusieurs améliorations à l’interface d’administration.

La page À propos a été entièrement mise à jour afin de présenter les principales évolutions de Retraceur 4.0.0 et d’orienter plus facilement les administrateur·rice·s vers la documentation du projet.

Les écrans dédiés aux extensions, aux blocs et aux mises à jour bénéficient également de panneaux d’aide plus complets et plus cohérents avec les nouvelles possibilités offertes par Retraceur.

L’expérience de découverte des blocs et des extensions a été enrichie. Lorsqu’une requête de « topic GitHub » ne renvoie aucun résultat, Retraceur invite désormais les administrateur·rice·s à consulter la documentation expliquant comment rendre des extensions ou des blocs découvrables par l’API. Ce cas se présente pour l’écran de découverte des extensions, même si les extensions peuvent d’ores et déjà être référencées grâce au « topic » retraceur-plugin.

Enfin, plusieurs ajustements ont été apportés aux interfaces d’administration : amélioration des messages affichés lors d’un échec d’installation, correction des liens de retour après le remplacement manuel d’un bloc ou d’une extension et suppression de l’action groupée de mise à jour des extensions et des blocs, que je considère redondante depuis l’enrichissement de l’interface centralisée des mises à niveau du cœur de Retraceur.

La documentation continue de s’enrichir

Cette troisième bêta s’accompagne également d’un important travail sur la documentation. Deux pages existantes ont été actualisées afin de refléter les dernières évolutions apportées à Retraceur 4.0.0.

La page consacrée à la gestion des mises à jour ne se limite désormais plus au cœur du logiciel. Elle décrit également le fonctionnement des mises à jour des extensions et des blocs, désormais intégrés au nouveau système introduit par Retraceur 4.0.0.

La documentation dédiée à la gestion des blocs a également été revue afin de tenir compte des évolutions de l’interface d’administration et de la simplification du téléchargement manuel des blocs.

Cette bêta est également l’occasion de publier une nouvelle page consacrée à la découverte des blocs.

Alors que la documentation publiée lors de la bêta 2 expliquait aux développeur·euse·s comment rendre leurs extensions et leurs blocs découvrables par l’API, cette nouvelle page s’adresse aux administrateur·rice·s.

Elle présente le fonctionnement de la nouvelle interface de découverte tout en rappelant un point essentiel : Retraceur facilite l’accès à des ressources publiées librement, mais n’en assure ni la modération ni la validation en matière de sécurité. Il appartient donc à chacun d’explorer ce carrefour ouvert avec le même discernement que celui qu’il exercerait en naviguant sur le Web.

Rendez-vous pour la version candidate

Cette troisième bêta a vocation à être la dernière étape avant la version candidate.

Si aucun nouveau problème n’est identifié au cours des prochains jours, la prochaine publication sera donc la version candidate, avant la sortie de Retraceur 4.0.0, désormais prévue le 4 août.

Merci à toutes celles et ceux qui prennent le temps de suivre ces différentes étapes, de tester les versions de développement ou simplement de s’intéresser au projet. Chaque retour contribue à rendre Retraceur un peu plus robuste.

Crédits Photo à la une : Zairon CC BY-SA 4.0