Retour à la leçon·Leçon 6 sur 8·La page qu'il doit survivre
La légende est la seule partie qui voyage
Le même diaporama que les téléchargements, rendu sous forme de page. Lancez le diaporama pour le présenter en plein écran — les flèches ou un clic avancent d'une diapositive, Échap quitte.
Ce que couvre cette leçon
- Supposez qu'elle sera reprise
- Quatre choses qu'une légende doit porter
- Le titre et la légende font deux travaux différents
- L'étiquetage à l'intérieur du graphique
- Les nombres dans une légende bilingue
- Le test des cinq secondes
- Rapportez-le en entier
- La suite
Notes du présentateur
Quelqu'un collera votre figure dans un rapport de situation sans le paragraphe qui l'expliquait. Ce que dit la légende est ce que la figure signifiera désormais, elle doit donc porter le constat, le dénominateur et ce que le graphique ne peut pas étayer.Supposez qu'elle sera reprise
- Écrivez pour la seconde vie — La légende est la seule partie de l'analyse qui voyage avec l'image, elle doit donc se…
Notes du présentateur
Une figure dans un rapport de programme a une seconde vie. Elle est capturée dans un rapport de situation, collée dans une présentation de cluster, transférée comme image et reproduite dans une mise à jour bailleur — chaque fois sans le paragraphe qui la précédait. Écrivez pour la seconde vie. La légende est la seule partie de l'analyse qui voyage avec l'image, elle doit donc se suffire à elle-même.Supposez qu'elle sera reprise
Légende Ce qui survit au collage « MAG par commune » Le graphique, sans interprétation « Figure 3 » Rien « MAG par commune avec IC à 95 %. Les trois communes mises en évidence sont les seules dont l'intervalle dépasse la médiane du district. » Le constat, l'incertitude et la limite Quatre choses qu'une légende doit porter
- Le constat, sous forme de phrase — Non pas ce que montre le graphique — ce qu'il dit
- Le dénominateur, ou où le trouver — 1 955 ménages, 1 850 cas, 24 écoles
- L'incertitude, si le graphique en porte — « avec intervalles de confiance à 95 % » fait cinq mots et empêche de lire le…
- Ce que le graphique n'étaye pas — Une proposition, et c'est celle qu'on supprime en premier quand quelqu'un raccourcit
Notes du présentateur
Le constat, sous forme de phrase. Non pas ce que montre le graphique — ce qu'il dit. « Compter les sources améliorées surestime la couverture dans chaque district » est un constat ; « Source améliorée contre service de base par district » est un nom de fichier. Le dénominateur, ou où le trouver. 1 955 ménages, 1 850 cas, 24 écoles. Un pourcentage sans dénominateur est un nombre qu'un lecteur ne peut pas peser. L'incertitude, si le graphique en porte. « avec intervalles de confiance à 95 % » fait cinq mots et empêche de lire le graphique comme douze valeurs exactes. Ce que le graphique n'étaye pas. Une proposition, et c'est celle qu'on supprime en premier quand quelqu'un raccourcit. « Les barres ne s'additionnent pas », ou « la comparaison est observationnelle », ou « un classement d'une commune contre sa voisine n'est pas étayé ».Quatre choses qu'une légende doit porter — En Python
CAPTION = ( "Four food security instruments applied to the same 1,955 households. " # denominator "The highest prevalence is seven times the lowest, " # finding "so the instrument chosen decides the caseload before any analysis begins." # implication )Quatre choses qu'une légende doit porter — En R
labs(caption = str_wrap(CAPTION, 90))Le titre et la légende font deux travaux différents
Élément Travail Longueur Titre Nomme la comparaison 3 à 6 mots Légende Énonce le constat et ses limites 2 à 3 phrases Étiquette d'axe Nomme la quantité et son unité 2 à 4 mots Étiquette directe Identifie une série sur place 1 à 3 mots Notes du présentateur
Un graphique qui a les deux ne doit pas dire deux fois la même chose.Le titre et la légende font deux travaux différents
- Si le titre énonce le constat, supprimez la légende ou le titre — Deux en-têtes qui se concurrencent est le défaut de…
- Sur cette plateforme, le titre nomme et la légende raconte — Chaque figure de
build.pyporte les deux, dans les deux…
Notes du présentateur
Si le titre énonce le constat, supprimez la légende ou le titre. Deux en-têtes qui se concurrencent est le défaut de mise en page le plus courant d'un rapport de programme, et celui qui charge une page sans rien ajouter. Sur cette plateforme, le titre nomme et la légende raconte. Chaque figure debuild.pyporte les deux, dans les deux langues, et la séparation est imposée par le fait que ce sont deux champs distincts.L'étiquetage à l'intérieur du graphique
- Les étiquettes directes battent les légendes — Une légende oblige le lecteur à associer une couleur à un nom puis à la…
Notes du présentateur
Quatre décisions qui déterminent si un lecteur doit détourner les yeux des données. Les étiquettes directes battent les légendes. Une légende oblige le lecteur à associer une couleur à un nom puis à la reporter sur le graphique ; une étiquette au bout de la ligne non.L'étiquetage à l'intérieur du graphique — En Python
for name, series in lines.items(): ax.plot(series.index, series.values) ax.annotate(name, (series.index[-1], series.iloc[-1]), xytext=(6, 0), textcoords="offset points", va="center")L'étiquetage à l'intérieur du graphique — En R
# ggrepel::geom_text_repel() on the last point of each series.L'étiquetage à l'intérieur du graphique
- N'étiquetez les valeurs que si le lecteur en a besoin exactement — Un diagramme en barres avec une valeur sur chaque…
- N'étiquetez jamais une valeur avec plus de précision que l'intervalle n'en justifie — 42,9 % sur une barre dont…
- Mettez l'unité sur l'axe, une fois — « Ménages signalés (%) » puis des nombres nus, non « % » répété à chaque graduation
Notes du présentateur
N'étiquetez les valeurs que si le lecteur en a besoin exactement. Un diagramme en barres avec une valeur sur chaque barre est un tableau déguisé en graphique. Étiquetez les barres mises en évidence, ou aucune. N'étiquetez jamais une valeur avec plus de précision que l'intervalle n'en justifie. 42,9 % sur une barre dont l'intervalle vaut ±3 points, non 42,94 %. Mettez l'unité sur l'axe, une fois. « Ménages signalés (%) » puis des nombres nus, non « % » répété à chaque graduation.Les nombres dans une légende bilingue — En Python
caption={ "en": "Counting improved sources overstates coverage in every district. " "The difference is households whose source is improved and more than " "thirty minutes away.", "fr": "Compter les sources améliorées surestime la couverture dans chaque " "district. L'écart correspond aux ménages dont la source est améliorée " "et située à plus de trente minutes.", }Notes du présentateur
Cette plateforme livre chaque figure en deux langues, et la légende est l'endroit où les deux divergent le plus.Les nombres dans une légende bilingue — En R
# One figure, two captions, written together rather than translated later.Les nombres dans une légende bilingue
- Le séparateur décimal change — 42,9 % en français, 42.9% en anglais — et le moteur de rendu s'en charge, ce qui est la…
- L'espace devant le signe pour cent change aussi — et le français emploie une espace fine insécable
- Traduisez le constat, non les mots — Une légende française qui se lit comme une traduction a échoué au même test qu'une…
Notes du présentateur
Le séparateur décimal change — 42,9 % en français, 42.9% en anglais — et le moteur de rendu s'en charge, ce qui est la raison pour laquelle la figure porte des valeurs et non des chaînes formatées. L'espace devant le signe pour cent change aussi, et le français emploie une espace fine insécable. Obtenez-la du formateur plutôt que de la saisir. Traduisez le constat, non les mots. Une légende française qui se lit comme une traduction a échoué au même test qu'une leçon française qui se lit ainsi.Le test des cinq secondes
- S'il décrit le graphique, la légende est un titre — « C'est un diagramme en barres des communes » signifie que la…
- S'il énonce le constat, elle fonctionne — « Trois communes sont nettement au-dessus des autres » est une légende qui a…
- S'il énonce un constat que vous n'avez pas fait, corrigez le graphique — Un lecteur qui dit « donc Dessalines est la…
Notes du présentateur
Montrez la figure et sa légende à quelqu'un qui n'était pas dans l'analyse, et demandez ce qu'elle dit. S'il décrit le graphique, la légende est un titre. « C'est un diagramme en barres des communes » signifie que la légende n'a rien fait. S'il énonce le constat, elle fonctionne. « Trois communes sont nettement au-dessus des autres » est une légende qui a fait son travail. S'il énonce un constat que vous n'avez pas fait, corrigez le graphique. Un lecteur qui dit « donc Dessalines est la plus sûre » a lu un classement que les intervalles n'étayent pas, et il manque à la légende la proposition qui l'écarte.Rapportez-le en entier — Exemple
Figure captions in this report Every figure caption states the finding as a sentence, names the denominator, and names one thing the figure does not support. Captions are written to be self-contained: a figure reproduced without its surrounding text should still carry its own interpretation and its own limits. Values are labelled to the precision the confidence interval supports and no further. Figures and captions exist in English and French. The captions are written in both languages rather than translated, so the finding rather than the wording is what is shared.Rapportez-le en entier
- Le deuxième paragraphe est toute la leçon — et c'est une affirmation sur la robustesse du rapport plutôt que sur son…
Notes du présentateur
Le deuxième paragraphe est toute la leçon, et c'est une affirmation sur la robustesse du rapport plutôt que sur son style.La suite
- Tout ce qui précède portait sur ce que dit le graphique.
Notes du présentateur
Tout ce qui précède portait sur ce que dit le graphique. La leçon suivante porte sur l'axe, là où un graphique peut dire autre chose que ses propres données sans qu'un seul nombre soit faux.