为什么这个仓库同时保留文档站与模板族

这个仓库不是单纯的“文章集合”，也不是单纯的“代码示例集合”。

它同时维护两层能力：

• 一层是稳定知识层，也就是教程、术语、API 手册和附录
• 一层是可复制工程层，也就是 simple、standard、enterprise 三套模板

如果只保留文档，不保留模板，读者学完以后仍然要自己补一套工程骨架。

如果只保留模板，不保留文档，读者拿到骨架以后很难理解为什么这样拆层、为什么这样组织诊断和测试。

因此这两个部分必须同时存在：

• 文档负责解释“为什么”
• 模板负责落实“怎么做”

当前项目里的分工

在当前仓库里：

• docs/ 负责权威知识表达
• templates/ 负责起步骨架和工程脚手架
• src/ 负责真实案例和测试验证

这三者组合起来，才是一个完整的学习与落地闭环。

为什么博客还要单独存在

教程和模板解决的是“稳定内容”，但仓库演进过程中还会产生很多时间流内容，例如：

• 某次模板升级为什么这样做
• 某次重构踩了什么坑
• 某次部署调整为什么改动 Compose

这些内容如果直接塞回教程或附录，会把稳定知识层污染成日志层。

因此独立博客站的价值，就是承接这些“变化中的内容”。