Kiali CRD参考文档优化：提升YAML示例可读性

在Kubernetes生态系统中，Kiali作为服务网格可视化工具，其自定义资源定义(CRD)的参考文档是运维人员配置部署的重要依据。近期社区反馈表明，当前CRD文档中的YAML片段示例存在理解门槛，特别是对于初级用户容易产生困惑。

问题的核心在于文档中的示例代码片段未展示完整的层级结构。以部署配置中的自定义密钥(custom_secrets)为例，原文档仅展示了片段：

deployment:
  custom_secrets:
  - name: mysecret
    mount: /mysecret-path

这种片段式示例虽然节省空间，但缺乏上下文关联，导致用户在实际编写CR时难以准确定位配置项在整体YAML结构中的位置。更合理的做法是从spec层级开始展示完整路径：

spec:
  deployment:
    custom_secrets:
    - name: mysecret
      mount: /mysecret-path

这种改进具有多重技术价值：

1. 上下文完整性：明确展示配置项在CRD中的完整路径，避免用户混淆
2. 直接可用性：示例可直接嵌入到用户的CR文件中，减少试错成本
3. 学习友好性：通过完整结构展示帮助用户理解Kiali CRD的层次模型

从实现角度看，该优化涉及对Kiali Operator代码库中CRD文档生成模板的修改。开发者需要遍历所有示例片段，确保每个配置示例都从spec层级开始定义。这种改动虽然机械但影响深远，能显著降低用户的理解负担。

对于Kubernetes CRD设计而言，这实际上反映了一个通用最佳实践：示例代码应该保持足够的上下文，特别是在涉及多层嵌套的配置结构时。这种实践不仅适用于Kiali，对于任何需要用户编写复杂YAML/JSON配置的Kubernetes生态项目都具有参考价值。

该优化已随Kiali Operator v2.6.0版本发布，用户在升级后将获得更清晰易懂的配置参考文档。对于正在学习服务网格监控的运维团队，建议特别关注此次文档改进，它能帮助更快掌握Kiali的定制化部署配置技巧。