媒体

在控制维护负担的同时高效使用媒体。

本页介绍在文档中使用截图、GIF 和视频的最佳实践。

截图、GIF 和视频可以增强文档效果，但随着 UI 元素变化，它们也需要持续维护。请有选择地使用，以避免不必要的维护工作。

关键原则：

• 媒体应起到补充作用。 如果仅用文字就能清晰说明流程，就应避免再添加视觉元素。
• 确保无障碍可访问性。 为图片添加 alt 文本，为视频添加字幕，为音频内容提供文字稿。很多人会使用辅助技术，而无障碍内容能惠及所有用户。
• 在清晰度与可维护性之间取得平衡。 频繁的 UI 变更会让截图和视频很快过时。请评估更新它们所需的投入，是否值得它们带来的价值。

​

何时使用媒体

• 截图：用于那些难以用文字清晰说明的任务。
• GIF：用于宣传推广，以及简短但流程复杂的演示。
• 视频：用于解释抽象概念和较长的工作流程。

谨慎且有目的地使用媒体，以避免不必要的文档债务。使用得当时，它能在不增加维护负担或无障碍门槛的情况下提升理解。