Skip to content

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 层入口):

  1. 复制本模板
  2. 改 title、layer、group
  3. 填"关键产出物"表(每行必须真实有用,不能凑数)
  4. 填"阅读路径"——站在读者角度,不是文档顺序

常见误区

  1. "关键产出物"表只列章节名——必须列"它回答什么问题"+ "用什么工具"
  2. "子主题"写成"1. 战略建模 2. 战术建模..." —— 没有"一句话定位"读者看不出区别
  3. 没有"阅读路径"——读者不知道"我是新读者该怎么办"

关键洞察

概览页 = 读者的"第一印象"

如果读者打开 L1 概览页 30 秒内不知道"这层在做什么、我从这里该看什么"——这层就是失败的。

相关链接

从名家方法论与工程化思路中蒸馏出自己的工程体系。