用途:在 Kibana 仓库中把面向用户的 kibana.yml 设置和 Advanced Settings(uiSettings)条目写入 docs-builder 的 {settings} YAML,而不是自由格式 Markdown。
主要能力:按用户修改位置分类——kibana.yml/Cloud 用户设置写入 docs/reference/configuration-reference/<area>-settings.yml;Space Settings 写入 docs/reference/advanced-settings-space.yml;Global Settings 写入 docs/reference/advanced-settings-global.yml。同一 PR 若同时新增 config-schema 字段和 uiSettings 注册,需分别记录。
使用方式:用 git grep 在 docs/reference 中查找已有分组并就近复制同级条目;从插件 kibana.jsonc 解析 configPath;从注册代码读取 key、类型、默认值、category 与可用性;按 docs-builder 设置页填写 applies_to;用 docs-builder serve 预览 Supported on 徽章。kibana.yml 的 ech 需对照 elastic/cloud 的 Cloud 用户设置允许列表,Advanced Settings 的 serverless 需查 common/index.ts 及各项目允许列表。
限制:不得把 kibana.yml 键写入 Advanced Settings YAML,反之亦然;不得为内部标志、仅测试配置或已有弃用覆盖的重命名添加 YAML;不得凭 issue 或 PR 标题填写默认值、类型或可用性;不得用 UI 标签、测试 ID 或组件名作为 YAML 设置键;实现教程仍留在 docs/extend/tutorials 下。