DNA: started from explanation-graphs.md
Root ·
Started from docs/dna/explanation-graphs.md in the Knowen repository: How Knowen works is kept with the code.
Changes to the content
# Explanation graphs ⏎ **What it is.** An explanation graph is a set of short explanations, called **nodes**, connected by **edges**. Each edge goes from a node to a more specific node that its explanation builds on: from *Classical mechanics* to *Newton's laws*, from *Newton's laws* to *Force*. ⏎ **Why it helps.** A reader can start anywhere and go as deep as they need: the general picture first, the details on demand, and never a wall of text. A writer can improve one idea without rewriting a chapter. And because the structure is explicit, people and agents can see what is missing, what is duplicated, and where a new piece belongs. ⏎ **How it works here.** A node explains one idea and keeps its full history. Its children are what its explanation needs, at most five of them. A node needed in several places has several parents, all equal. Many sources grow one graph. Each is explained below, along with where the idea of an explanation graph comes from; how to see a graph on screen is in [Seeing a graph](dna:seeing-a-graph). ⏎ **How it is built.** Nodes are stored with their text, history and permissions; edges are typed links that the database keeps free of loops. A node can be private or public, and a private graph can be attached to a public node without becoming part of it. ⏎ # Parents ⏎ * How Knowen works⏎
Feedback00
No feedback yet. Say whether this change improves the node.
Sign in to add a new comment.
