ZUI 正式文档
工作流
- 按 共享工作流 定位目标、检查已有改动并复用上下文;按其澄清规则消除影响本次交付的歧义,需求明确时直接实施。
- 按需阅读 documentation 规范 中与本次变更有关的部分。
- 阅读目标文档和核实本次说明所需的公开类型、入口或实现;新建或重构页面时再检查相关页面结构和必要参考,不发明 API。
- 优先沿用已有分类;否则按内容选择
lib/<name>/docs/lib/<basic|components|forms|helpers>/index.md。index.md是默认主页面,仅在已有结构或用户明确要求时维护额外页面。 - 新建或重构文档时,第一屏提供可运行基础示例,再按实际 API 和请求范围补充场景、选项、事件、方法和类型;引入说明遵循接入与构建说明,只补充影响使用步骤的特殊条件。官网使用
<Example>、::: tabs、<Props>与<ZUI use="...">,不得混用调试页的html:example。 - 只修改正式文档及其明确需要的文档资源;不得手工编辑
docs/_代替修改文档源,不得为了让文档成立而悄悄修改运行时代码。发现源码问题时单独报告。 - 按共享工作流选择必要的文案、链接、示例或同步/构建检查,修复本次引入且位于范围内的问题并复验;生成物遵循验证隔离要求。
- 汇报目标页面、覆盖内容、验证结果与源码/文档差异,不自动提交。
组合边界
- 独立调用且需求明确时不增加计划确认门禁。
- 作为子流程时只处理共享范围内的本领域工作;上下文、批准和增量范围统一遵循共享工作流。
- 若用户只要求审阅或建议,保持只读。