Type A 概览页
解决什么问题:L 层入口、meta 分区索引——读者从这里开始整个 layer 的探索。
它是什么
Type A 文档是 wiki 的"地图页"——读者通过它了解"这一层在做什么、有什么子主题、怎么读"。
典型例子:
l1-modeling/01-overview/(L1 入口)meta/source/cybernetics/(源典分区索引)meta/writing-style/(写作范式总览)
特征:
- 不深入任何具体概念(不解释"是什么")
- 给"全局视图"(有什么、怎么读、彼此关系)
- 篇幅 50-80 行
结构模板
markdown
---
title: [Layer/分区] 名称
type: overview
layer: [L1 | L2 | L3 | L4 | L5 | meta]
group: [group-name]
status: mature
last_updated: YYYY-MM-DD
---
# [emoji] [名称]
> [一句话定位——这一层/分区解决什么问题]
## 这一层/分区在做什么
[1-2 段说明: 核心问题、产出形态]
## 关键产出物
| 产物 | 它回答的问题 | 关键工具 |
|---|---|---|
| ... | ... | ... |
## 子主题
[列表, 每个子主题 1 行说明]
1. **[子主题 1]**——一句话定位
2. **[子主题 2]**——一句话定位
...
## 阅读路径
**新读者**:
1. [第一篇](/path/)
2. [第二篇](/path/)
...
**带着问题来的读者**: 直接进对应 sidebar group。
## 与其他文档的关系
[一段或图, 说明这一层与相邻层的关系]
- [相关链接 1](/path/)
- [相关链接 2](/path/)
- [源典精读](/path/)
## 相关链接
- [首页](/)
- [相邻 L 层](/path/)
- [其他相关](/path/)必填 section(6 个)
| section | 作用 | 篇幅 |
|---|---|---|
# [name] | 主标题 | 1 行 |
> 解决什么问题 | 定位句 | 1 行 |
## 这一层在做什么 | 核心问题说明 | 1-2 段 |
## 关键产出物 | 表格——有什么、回答什么、用什么 | 5-8 行表格 |
## 子主题 | 列表——分几块 | 3-6 项 |
## 阅读路径 | 怎么读 | 5-10 行 |
## 与其他文档的关系 | 与上下层/相邻文档的连接 | 1 段或 mermaid |
## 相关链接 | 反向链接 | 3-5 条 |
怎么用
新建 Type A 文档(如新加一个 L 层入口):
- 复制本模板
- 改 title、layer、group
- 填"关键产出物"表(每行必须真实有用,不能凑数)
- 填"阅读路径"——站在读者角度,不是文档顺序
常见误区
- "关键产出物"表只列章节名——必须列"它回答什么问题"+ "用什么工具"
- "子主题"写成"1. 战略建模 2. 战术建模..." —— 没有"一句话定位"读者看不出区别
- 没有"阅读路径"——读者不知道"我是新读者该怎么办"
关键洞察
概览页 = 读者的"第一印象"
如果读者打开 L1 概览页 30 秒内不知道"这层在做什么、我从这里该看什么"——这层就是失败的。