From f12ce6272274791b1ebd7620684779410cd19273 Mon Sep 17 00:00:00 2001
From: Levi Neely <141506390+lneely@users.noreply.github.com>
Date: Sun, 30 Nov 2025 14:11:21 +0100
Subject: [PATCH] extension docs

---
 EXTENDING.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/EXTENDING.md b/EXTENDING.md
index d536a3b..4f1e29f 100644
--- a/EXTENDING.md
+++ b/EXTENDING.md
@@ -1,5 +1,7 @@
 # Extending acme-denote
 
+## Architecture
+
 `acme-denote` is extended by building programs upon its 9P API.
 
 ```
@@ -86,6 +88,8 @@ plumb $notepath
 
 ### Metadata Manipulation (e.g., Dmerge)
 
+`Dmerge` performs metadata manipulation, and it also illustrates an important architectural concept: the `acme-denote` program manages metadata, not content (the latter is a function of the appropriate editor). Therefore, content manipulation is performed directly on the filesystem.
+
 ```rc
 # Read source content
 sourcepath=`{9p read denote/n/$sourceid/path}