DNA: started from parents-and-children.md

Root ·

Started 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](media/theme-node.svg)
⏎
**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)). 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.
⏎
# Parents
⏎
* Explanation graphs⏎

Feedback00

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

Sign in to add a new comment.