Messages utilisateur : Informations destinées à être lues par l'utilisateur final, souvent pour expliquer le fonctionnement du programme.
- Utiliser print() pour afficher des messages clairs
- Formuler les messages de manière compréhensible
- Utiliser des messages pertinents pour guider l'utilisateur
- Éviter les messages techniques inutiles pour l'utilisateur
Déterminer quels messages aideront l'utilisateur à comprendre le programme
Utiliser un langage simple et éviter le jargon technique
Afficher les messages au moment opportun dans le programme
Messages clairs et utiles qui guident l'utilisateur dans l'utilisation du programme
• Clarté : Les messages doivent être compréhensibles pour l'utilisateur
• Pertinence : Afficher uniquement les informations utiles
• Contexte : Les messages doivent être adaptés au contexte d'utilisation
Messages de debug : Informations temporaires pour aider le développeur à comprendre l'exécution du programme.
Repérer les endroits où l'état du programme doit être surveillé
Utiliser des préfixes comme "[DEBUG]" pour distinguer les messages
Inclure les valeurs des variables critiques dans les messages
Informations détaillées pour suivre l'exécution du programme pendant le développement
• Identification : Marquer clairement les messages de debug
• Variables : Afficher les valeurs des variables critiques
• Suppression : Supprimer les messages de debug avant la production
Messages d'erreur : Informations claires et utiles pour indiquer à l'utilisateur ce qui s'est mal passé et comment le corriger.
Identifier les situations qui peuvent entraîner des erreurs
Expliquer ce qui s'est mal passé et comment le corriger
Donner des instructions précises pour corriger l'erreur
Messages clairs qui expliquent l'erreur et proposent une solution
• Explication : Expliquer clairement ce qui s'est mal passé
• Solution : Proposer une façon de corriger l'erreur
• Politesse : Utiliser un ton respectueux et utile
Formatage des messages : Organisation visuelle des messages pour améliorer la lisibilité et la compréhension.
Déterminer comment organiser les informations dans le message
Appliquer des lignes ou des caractères pour structurer le message
Utiliser des formats appropriés pour les nombres, dates, etc.
Sortie bien structurée qui améliore la lisibilité et la compréhension
• Structuration : Utiliser des séparateurs pour organiser les informations
• Alignement : Aligner les éléments pour une meilleure lisibilité
• Formatage : Formater les données selon leur type (nombres, dates, etc.)
Messages de progression : Informations qui indiquent l'avancement d'une tâche longue pour rassurer l'utilisateur.
Déterminer le pourcentage d'avancement de la tâche
Mettre à jour l'utilisateur à intervalles réguliers
Si possible, indiquer le temps restant ou les étapes restantes
Informations régulières qui rassurent l'utilisateur sur l'avancement du processus
• Fréquence : Ne pas surcharger l'utilisateur avec trop de messages
• Clarté : Indiquer clairement le pourcentage d'avancement
• Utilité : Fournir des informations utiles pour gérer les attentes
- Information : Messages pour informer l'utilisateur du fonctionnement du programme
- Debug : Messages pour le développeur pendant le développement
- Erreur : Messages indiquant qu'une erreur s'est produite
- Progression : Messages indiquant l'avancement d'une tâche longue
- Confirmation : Messages confirmant l'exécution d'une action
- Les messages doivent être compréhensibles pour le public cible
- Les messages de debug doivent être identifiables et supprimables
- Les messages d'erreur doivent proposer une solution
- Les messages doivent être adaptés au contexte d'utilisation
- La quantité de messages doit être équilibrée (ni trop ni trop peu)