DNA: started from nodes.md

Root ·

Started from docs/dna/nodes.md in the Knowen repository: How Knowen works is kept with the code.

Changes to the content

# Nodes
⏎
**What it is.** A node explains one idea well enough to be read on its own. It has a title, a body in Markdown, and links to its parents and children. It can carry math (written in LaTeX), figures, tables and references found by DOI or arXiv ID.
⏎
**Why one idea.** Small nodes can be reused wherever an idea is needed, improved without touching their neighbours, and owned by the people who wrote them. A node that tries to explain three things is better as three nodes.
⏎
**What comes with it.**
- **History:** every saved change is a version, with a title and, on public nodes, a description of what changed and why. Versions can be compared word by word.
- **Talk:** a page for questions, disputes and discussions about the node.
- **Owners:** on the public graph, the people who decide what changes in it (see [Who owns what](dna:who-owns-what)).
- **Files:** attachments such as PDFs and images.
⏎
**How it is built.** A node is a database record with its content, its author's handle and its visibility; its versions are kept in full, so nothing is ever lost. Search indexes its text, and, where it is switched on, its meaning.
⏎
**Limits.** A node has one title and one current text; alternatives live in forks and proposals until their owners decide.
⏎
# Parents
⏎
* Explanation graphs⏎

Feedback00

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

Sign in to add a new comment.