以问答方式整理我在微服务规模增大后开始补上的两类结构化文档：ADR 记录"为什么这样"，catalog-info.yaml 记录"是什么、归谁、依赖什么"。

记录我在多仓库微服务项目里整理文档体系时采用的一种思路：中央架构 Repo + 各服务 Repo 内 /docs/ 目录 + Docusaurus 统一入口，尽量让文档贴近代码，同时保留统一检索入口。