« The Interactivity API is a new standard system of APIs to add interactivity to blocks, both front-end and back-end » : la formulation vient directement de la proposition publiée sur Make WordPress Core au premier semestre 2023, et elle décrit un chantier encore expérimental à ce stade, disponible en test via le plugin Gutenberg mais absent de toute version stable de WordPress. Le distinguer clairement d’une fonctionnalité déjà livrée, c’est la moitié du travail éditorial d’une notice technique bien faite.
Le problème que ce type de notice résout n’est pas l’information elle-même, disponible publiquement pour qui suit le Make, mais sa distribution interne. Une agence qui gère quinze sites WordPress ne peut pas attendre que chaque développeur lise individuellement les billets de Make Core ; et une notice envoyée à toute l’équipe, y compris aux rédacteurs et chargés de compte, se transforme vite en bruit qu’on ignore.
Cibler la bonne audience, pas tout le monde
Une notice d’administration filtrée par capacité plutôt que par rôle nommé reste robuste même si l’organisation des rôles change. current_user_can( 'edit_theme_options' ) ou une capacité personnalisée dédiée à l’équipe technique évite d’exposer une information hors sujet à un profil qui n’en a pas l’usage.
add_action( 'admin_notices', function () {
if ( ! current_user_can( 'edit_theme_options' ) ) {
return;
}
$vue_le = get_user_meta( get_current_user_id(), 'veille_interactivity_api_vue', true );
if ( $vue_le ) {
return;
}
printf(
'%s
',
esc_html__(
'Veille technique : l\'Interactivity API (proposition Gutenberg, encore expérimentale) prépare une nouvelle façon de rendre les blocs interactifs côté front. À suivre avant sa stabilisation, pas encore à utiliser en production.',
'agence-veille'
)
);
} );
Mémoriser la lecture sans forcer une action
Un appel AJAX déclenché au clic sur la croix de fermeture de la notice, enregistrant un user_meta horodaté, évite de réafficher indéfiniment la même information à quelqu’un qui l’a déjà lue — sans pour autant la masquer pour les autres membres de l’équipe technique qui ne l’ont pas encore vue.
Résumer sans trahir la source
Le piège classique d’une notice de veille est de reformuler la nouveauté en l’amplifiant, jusqu’à laisser croire qu’une fonctionnalité expérimentale serait déjà utilisable en production. En octobre 2023, l’Interactivity API n’existe que sous forme de proposition et d’implémentation de test dans le plugin Gutenberg ; elle ne devient une API publique stable qu’avec WordPress 6.5, au printemps 2024. Une notice honnête doit porter cette nuance, faute de quoi un développeur pressé pourrait commencer à l’intégrer sur un projet client bien avant qu’elle soit fiable.
- Toujours mentionner le statut réel : proposition, expérimental, bêta, stable
- Lier vers la source officielle (Make WordPress Core) plutôt que de la paraphraser entièrement
- Ne jamais recommander une adoption en production sur la base d’une simple annonce
Une notice de veille qui donne envie d’expérimenter en local est utile ; une notice qui donne envie de livrer en production sur une fonctionnalité expérimentale est dangereuse.
Donner une date de péremption à l’information
Une notice de veille technique n’a pas vocation à rester affichée indéfiniment : au-delà de trois mois, l’information a probablement évolué, et la notice devient trompeuse par obsolescence plutôt que par erreur initiale. Un simple test sur une option horodatée à la création de la notice permet de la retirer automatiquement passé ce délai, sans qu’un développeur ait besoin d’y repenser.
add_action( 'admin_init', function () {
$cree_le = get_option( 'veille_interactivity_api_creee_le' );
if ( ! $cree_le ) {
update_option( 'veille_interactivity_api_creee_le', time() );
return;
}
if ( time() - $cree_le > 90 * DAY_IN_SECONDS ) {
remove_action( 'admin_notices', 'agence_notice_interactivity_api' );
}
} );
En résumé
Une notice de veille technique bien construite ne se contente pas de relayer une annonce : elle la cible sur la bonne audience, elle respecte le statut réel de la technologie décrite, et elle sait s’effacer d’elle-même une fois périmée. Pour l’Interactivity API en particulier, la prudence de cette fin d’année 2023 tient en une phrase : à suivre de près, à ne surtout pas déployer en production tant que la stabilisation annoncée pour WordPress 6.5 n’est pas actée.
