DNA: started from edit-and-commit.md

Root ·

Started from docs/dna/edit-and-commit.md in the Knowen repository: How Knowen works is kept with the code.

Changes to the content

# Edit a node and commit
⏎
**Goal:** improve a node's text and save it as a version others can see in its history.
⏎
**Before you start:** you can edit nodes of your own graphs and of graphs you collaborate on. On a public node you own, you edit it directly; on one you don't own, Edit opens your fork instead (see [Suggest an edit to a public node](dna:suggest-an-edit)).
⏎
1. Open the node and choose **⋮ › Edit node**. One person edits a node at a time; if someone else is editing it, you can ask them to release it.
2. Write in Markdown. **Split** shows the text and its preview side by side; the toolbar adds headings, lists, quotes, references by DOI or arXiv ID, images, and math (LaTeX between dollar signs).
3. In the bar at the bottom, give the change a title. Knowen suggests one, such as "Edited Pendulum"; **Add description** says why.
⏎
   ![The editor on a private node, with the commit bar at the bottom](media/edit-and-commit.webp)
4. Click **Commit changes**. On a public node, the title and "What changed and why" are both required.
⏎
**Not finished?** **Save draft and close** keeps your unsaved text under **Drafts**, to come back to; **Discard changes** throws it away.
⏎
**What happens next.** The commit is a new version: **History** on the node lists it with its title, and shows a word-by-word comparison with the version before.
⏎
**Undo.** Nothing is overwritten. To go back, open History, read the earlier text, and commit it again as a new version.
⏎
# Parents
⏎
* Writing and editing
* Drafts⏎

Feedback00

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

Sign in to add a new comment.