warn-before-the-thing-you-are-warning-about
Un avertissement placé après l'action qu'il concerne arrive alors que le lecteur a déjà décidé. Mettez-le au-dessus et, quand cela compte, rendez-le impossible à ignorer.
Conférée par la personne qui a relu la fiche, et non revendiquée par le fichier lui-même. Une fiche que l'agent distille au cours d'une exécution ayant consommé du contenu non fiable naît contaminée et reste en attente de relecture avant d'être un jour récupérée.
Quand elle vient à l'esprit
- rédiger une page de téléchargement
- ajouter une action destructive
- documenter un piège
- où placer cet avertissement
C'est dans À éviter et Vérifier que se trouve d'ordinaire la valeur. À faire est la section que tout le monde écrit.
Le corps de la fiche ci-dessus est une traduction. L'original anglais est ce que la CLI importe, ce que l'agent lit à l'exécution et ce que l'empreinte ci-dessous atteste.
Déclencheur
Quelque chose qu'un utilisateur s'apprête à faire a une conséquence à laquelle il ne s'attendra pas : un installateur non signé que son OS bloquera, une commande qui réécrit l'historique, un paramètre qui retire un humain d'une boucle, un export qui sort du sandbox.
Cela ne s'applique pas aux conséquences évidentes d'après le libellé. « Supprimer » n'a pas besoin d'un paragraphe expliquant que ça supprime.
À faire
- Placez l'avertissement au-dessus du contrôle, dans l'ordre de lecture, pas en dessous et pas dans une infobulle.
- Dites ce qui va se passer dans les termes de l'utilisateur — le texte exact de la boîte de dialogue qu'il verra, l'erreur exacte — puis quoi faire à ce sujet.
- Réservez l'interruption à l'irréversible. Une confirmation sur une action mineure habitue les gens à cliquer sans lire sur la confirmation qui compte vraiment.
- Si la surprise est inévitable et bénigne, expliquez pourquoi elle se produit. « Il n'y a pas de certificat de signature de code » transforme une boîte de dialogue alarmante en une boîte de dialogue attendue.
À éviter
Les avertissements après le bouton, les avertissements dans une section repliée, et les avertissements qu'un utilisateur peut fermer avant même d'avoir rencontré la situation. Ces trois cas sont le même échec : l'information arrive après la décision.
Évitez le flou qui a l'air responsable. « À utiliser avec prudence » ne donne au lecteur rien d'exploitable et sa vraie fonction est de protéger l'auteur plutôt que l'utilisateur.
Évitez d'avertir sur tout. Une page où cinq choses sont signalées n'a rien signalé du tout, et l'élément réellement dangereux est maintenant camouflé.
Vérifier
Lisez la page de haut en bas comme quelqu'un qui ne l'a jamais vue, et arrêtez-vous au moment où vous cliqueriez. L'avertissement était-il au-dessus de ce point ?
Vérifiez ensuite l'inverse : comptez les avertissements sur la surface. S'il y en a plus d'un bien visible, décidez lequel est le vrai et reléguez les autres au second plan.
Risque
Mettre les avertissements en avant alourdit la page et peut effrayer un utilisateur pour qui le risque n'était jamais réel. Ce coût est réel et ne vaut la peine d'être payé que là où la surprise est authentique.
Le mode d'échec de l'application excessive de ce principe est un produit qui donne l'impression d'être nerveux à propos de lui-même. Si chaque écran s'ouvre sur un avertissement, les avertissements deviennent du décor et le lecteur les saute — ce qui vous ramène au point de départ, avec un texte encore pire.
L'utiliser
La fiche est une donnée. Clonez le dépôt et importez-la par son chemin — ce qui arrive par le réseau est traité comme contaminé et retenu pour approbation, ce qui est le comportement souhaitable et la raison pour laquelle il n'y a pas d'installateur en une ligne ici.
git clone https://github.com/brcampidelli/chimera-agent.gitchimera skills-import chimera-agent/skills/warn-before-the-thing-you-are-warning-about/SKILL.mdIntégrité
SHA-256 du fichier tel qu'il est publié. Qui l'importe peut vérifier que ce qu'il a reçu correspond à ce que cette page affichait.
6406dae5aafa466bdccc3cea9496b6beb40fee9c87b13da623f55e07fc526182