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.
