用途:为 Video.js 10 撰写 RFC 文档。RFC 面向需要先获得他人支持的提案;若决策由自己负责,应改用 Design Doc(design 技能,internal/design/)。
何时写 RFC:改变公共 API 表面、影响产品方向、影响面向用户的开发体验、对核心架构有重大改动、需要他人认可时。
何时改用 Design Doc:自己负责领域的架构决策、内部实现选择、自己负责的设计模式或组件规格。
两者均跳过:缺陷修复、单一包内的小功能、实现细节、文档更新。
流程:识别需求(是否真需要认可)→ 起草提案(聚焦问题与方法,而非实现细节)→ 列出替代方案 → 明确权衡 → 收集反馈 → 迭代 → 获批后状态改为 accepted → 获批后撰写 Design Doc 补充细节。状态生命周期、分支工作流及其与实现计划的关系见 rfc/README.md。
完成前检查清单:问题陈述清晰(为何现在值得解决)、方案保持高层级(细节留待获批后的 Design Doc)、列出替代方案及利弊、明确权衡、列出开放问题、明确后续步骤(获批后做什么)、frontmatter 中 status 为 draft。
详细写作指导(渐进式披露、简洁性等)参见 design 技能的 Principles 部分,同样适用于 RFC。相关技能:自己负责的决策用 design,API 设计原则用 api,构建 UI 组件用 component,撰写文档用 docs。
限制:原文未提供安装方式、平台支持、价格等具体信息。