From 696fd13d860a98c7b1b6995a0fb46e488adf4f3f Mon Sep 17 00:00:00 2001
From: Lorin Gaertner <lorin@northarrowresearch.com>
Date: Thu, 18 Jun 2026 14:38:10 -0700
Subject: [PATCH] clarify description vs summary

---
 riverscapes_metadata/schema/CHANGELOG.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/riverscapes_metadata/schema/CHANGELOG.md b/riverscapes_metadata/schema/CHANGELOG.md
index 1ffc3bf7..ee95f498 100644
--- a/riverscapes_metadata/schema/CHANGELOG.md
+++ b/riverscapes_metadata/schema/CHANGELOG.md
@@ -6,6 +6,10 @@
 
 * adds `summary`, `citation`, and `xml_metadata` as optional elements for layers
 
+#### Comment
+
+In the Data Exchange, `Description` is meant as a long-form text. It can include markdown and can be multiple pages long (up to 100k characters). `Summary` is used as a one-sentence subtitle under the title (up to 500 characters). 
+
 ## 0.8.0
 
 ### Breaking changes