DNA: updated from parents-and-children.md

Root ·

Updated from docs/dna/parents-and-children.md in the Knowen repository: How Knowen works is kept with the code.

Changes to the content

# Parents and children

**The direction.** A parent's explanation needs its children: the children are the parts, the prerequisites or the details of the parent. Reading down the graph goes from general to specific; reading up shows why an idea matters.

**At most five children.** When a node needs more than five, the graph is telling you something: there is a grouping waiting to be named. Add a **theme** node (say, *Conservation laws*) and put the related children under it. Five keeps each level scannable, and forces the structure to say something.

![Six children under Mechanics; a theme node, Conservation laws, groups three of them](/dna/media/theme-node.svg?v=8fa77ca1)

**Where a new node goes.** Under the node whose explanation needs it. If several do, it gets several parents (see [Not a tree](dna:not-a-tree/nodes/29522)). If none does yet, it may be the start of a new graph.

**How it is built.** Each edge is a row linking a parent to a child; edges that would close a loop are refused, so the graph always has a direction. Special edges mark attached graphs, which are shown but not part of the graph they hang on.

**Limits.** Children have no fixed order on a node's page; the graph views lay them out by structure, and this manual orders its own pages by hand.

---
⏎
**Step by step**
⏎
- [Add a child or a second parent](/nodes/29523): Grow a graph downward with a child, or place a node under a second parent: no copy, one node needed by both.⏎
⏎
# Parents

* Explanation graphs

Feedback00

No feedback yet. Say whether this change improves the node.

Sign in to add a new comment.