---
name: 叙事
desc: 一条为读者穿越概念的路线、故事或动机。
category:
  - category-zh
  - meta-zh
  - concept-zh
belongs:
  - category-zh
---

叙事记录一条认知路线、故事或穿越概念的动机。

专著是主要的叙事形式。
它一次引入术语，之后便信任它们。

具象化的叙事也可能以指南的形式存在于 Lake 中。
它们可以声明前置知识、选择基础语言，
并以有意图的顺序引导读者穿越条目。
本 Lake 的 `introduction` 条目就是这样一个叙事。
`methodology` 条目是另一个叙事：
它给出了在 Lake 内行动的工作路线。

交互式叙事可以由技能临时生成。
规范知识保留在条目和元数据中。

叙事的关键在于排序。
一个概念可以是准确的，但对读者来说可能来得太早。
叙事选择什么必须先理解，
什么可以被命名并推迟，
什么局部细节应该留到后面。
它也可以解释为什么一条路线重要，
这样读者就能看到让这些概念变得有用的压力。

这对上手和评审很重要。
有经验的维护者可以直接查询一个条目。
新贡献者可能需要一条逐步构建模型的路线。
Sirno 让两条路线都能存在：
Lake 保持命名的对象稳定，
而叙事为特定的读者或任务编排这些对象。

具象化的叙事应避免重复整个 Lake。
它们应该解释为什么这条路线重要，
声明有用的前置知识，
并指向承载持久细节的条目。
交互式叙事可以更具适应性，
但仍应将条目视为持久项目知识的来源。

[generated-footer-zh]: generated-footer-zh.md "Generated Footer"

---

> **Sirno generated links begin. Do not edit this section.**

- belongs (to):
  - [category-zh](category-zh.md)
- belongs (from):
  - [bootstrap-resolution-zh](bootstrap-resolution-zh.md)
  - [methodology-zh](methodology-zh.md)
  - [perspective-and-terms-zh](perspective-and-terms-zh.md)
  - [readme-zh](readme-zh.md)

> **Sirno generated links end.**
