From 73c01f9e866f6d604e0b1ece8045d04287c3e4d4 Mon Sep 17 00:00:00 2001
From: DavIvek <david.ivekovic@memgraph.io>
Date: Tue, 17 Mar 2026 11:34:36 +0100
Subject: [PATCH] add optional description fields to nodes, edges, and
 properties

- nodes[].description: label description (optional, present only when set)
- nodes[].properties[].description: label-property or global property description
- edges[].description: edge type pattern or global edge type description
- edges[].properties[].description: edge-type-property or global property description
- Also expanded edges[].properties to show full property structure (key, count, types)
---
 v1/spec.json | 11 ++++++++---
 1 file changed, 8 insertions(+), 3 deletions(-)

diff --git a/v1/spec.json b/v1/spec.json
index 15b2735..864f366 100644
--- a/v1/spec.json
+++ b/v1/spec.json
@@ -1,8 +1,9 @@
 {
   "nodes": [{
-    "labels": [""], "count": 1,
+    "labels": [""], "count": 1, "description": "<optional>",
     "properties": [{
-      "key": "property_key_0", "count": 1, "filling_factor": 100.00, "types": [
+      "key": "property_key_0", "count": 1, "filling_factor": 100.00, "description": "<optional>",
+      "types": [
         { "type": "Null", "count": 1, "examples": [{}] },
         { "type": "String", "count": 1, "examples": [{}] },
         { "type": "Boolean", "count": 1, "examples": [{}] },
@@ -25,7 +26,11 @@
 
   "edges": [{
     "edge_type": "", "start_node_labels": [""], "end_node_labels": [""], "count": 1,
-    "properties": [{}],
+    "description": "<optional>",
+    "properties": [{
+      "key": "property_key_0", "count": 1, "filling_factor": 100.00, "description": "<optional>",
+      "types": [{}]
+    }],
     "examples": [{}]
   }],