videojs/v10

Docs: Improve Presets Concept Page Clarity

开放

#1,061 创建于 2026年3月20日

 (3 条评论) (0 个反应) (1 位负责人)TypeScript (67 个派生)github user discovery
docsgood first issuesite

仓库指标

星标
 (804 个星标)
PR 合并指标
 (平均合并 14天 19小时) (30 天内合并 55 个 PR)

描述

[!NOTE] Triage estimate — cycle priority and story points were assigned during an AI-assisted planning pass and are rough first guesses. Confirm or adjust when you pick this up.

Context

The presets concept page opens with a technical definition and then describes the /background preset's contents. A fresh reader may struggle to understand what presets are and when they'd reach for one.

Feedback from @davekiss:

I read the intro section for "Presets" and i'm still having trouble understanding what it actually is. may wanna take a pass on that for clarity. For the example that you use, you're describing the background preset and what it includes, but you might be better off describing the user's situation or use case that they are finding themselves in and then what preset they might reach for to solve for that use case.

Notes

Presets are a complicated topic — the current framing may just need a rewrite pass to lead with user scenarios rather than technical internals.

贡献者指南