mirror of
https://github.com/mintlify/docs.git
synced 2026-09-14 13:35:46 +08:00
mintlify[bot]
fbdd913d8e
* Add translation tracker for stale translations audit Generated-By: mintlify-agent * translations: add missing pages and update content for es, fr, zh Phase 1: Add translations for 4 new API analytics pages (feedback-by-page, searches, views, visitors) in es, fr, and zh. Phase 2: Update 3 pages with content changes: - agent/workflows: add "Disable a workflow" subsection - ai/skillmd: add 24-hour generation note - editor/publish: add AI PR title tip, reformat publishing workflows, promote "Publish your changes" heading from h3 to h2 Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> * update descriptions * translations * translations * translations * Delete TRANSLATION_TRACKER.md * translations * a * a * translations * translations * translations * translations * translations * translations * translations * translations * Update use-cases.mdx * translations * translations * Update ai-native.mdx * Update accordions.mdx * Update accordions.mdx * Update accordions.mdx * translations * translations * Update fonts.mdx * translations * translations: update SEO descriptions for es, fr, zh (150 pages) Update the description: frontmatter field across 150 pages × 3 languages to match the current English descriptions updated on 2026-03-31. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> --------- Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com> Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com> Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
27 lines
1.9 KiB
Plaintext
27 lines
1.9 KiB
Plaintext
---
|
||
title: "Médias"
|
||
description: "Utilisez efficacement images, captures d’écran, vidéos et diagrammes dans votre documentation tout en maîtrisant la taille des fichiers et les coûts de maintenance à long terme."
|
||
keywords: ["captures d'écran", "GIF", "vidéos", "bonnes pratiques pour les médias"]
|
||
---
|
||
|
||
<Tip>
|
||
Cette page explique les bonnes pratiques pour utiliser des captures d'écran, des GIF et des vidéos dans votre documentation.
|
||
</Tip>
|
||
|
||
Les captures d'écran, les GIF et les vidéos peuvent enrichir la documentation, mais nécessitent une maintenance continue à mesure que les éléments d'interface évoluent. Utilisez-les avec parcimonie pour éviter une surcharge de maintenance inutile.
|
||
|
||
Principes clés :
|
||
|
||
- **Les médias doivent être complémentaires.** Si un processus est clair avec le texte seul, évitez d'ajouter des éléments visuels.
|
||
- **Veillez à l'accessibilité.** Ajoutez un texte alternatif pour les images, des sous-titres pour les vidéos et des transcriptions pour le contenu audio. De nombreuses personnes utilisent des technologies d'assistance et un contenu accessible profite à tous les utilisateurs.
|
||
- **Équilibrez clarté et facilité de maintenance.** Des changements fréquents de l'interface peuvent rendre rapidement obsolètes les captures d'écran et les vidéos. Demandez-vous si l'effort nécessaire pour les mettre à jour se justifie par la valeur qu'ils apportent.
|
||
|
||
<div id="when-to-use-media">
|
||
## Quand utiliser des médias
|
||
</div>
|
||
|
||
* **Captures d’écran** pour les tâches difficiles à expliquer avec des mots.
|
||
* **GIF** à des fins promotionnelles et pour des flux de travail courts mais complexes.
|
||
* **Vidéos** pour les concepts abstraits et les longs flux de travail.
|
||
|
||
Utilisez les médias avec parcimonie et à bon escient pour éviter une dette de documentation inutile. Bien utilisés, ils améliorent la compréhension sans alourdir la maintenance ni créer de barrières à l’accessibilité. |