From df994466dc98f36252486ff44eab0f96e2c88cd9 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Rapha=C3=ABl=20de=20Courville?=
 <raphael@processingfoundation.org>
Date: Wed, 26 Mar 2025 12:41:12 +0100
Subject: [PATCH] Added feature description, use cases, and safety warning

---
 SCHEMA.md | 11 ++++++++++-
 1 file changed, 10 insertions(+), 1 deletion(-)

diff --git a/SCHEMA.md b/SCHEMA.md
index 23244be7f..b4a09f786 100644
--- a/SCHEMA.md
+++ b/SCHEMA.md
@@ -1,5 +1,14 @@
 # Processing URI Schema Definition
 
+The Processing URI schema defines a custom protocol for launching and interacting with the Processing Development Environment (PDE) via specially formatted `pde://` links. These links can be used to open sketches, create new ones, load hosted or base64-encoded files, and set preferences, all through a simple URI-based interface.
+
+This feature is primarily intended for integration with web platforms, tutorials, documentation, or third-party tools that want to streamline the experience of launching sketches in Processing from a web page. 
+
+Because these links can be generated dynamically, they support a range of interactive use cases. For example, an online editor could generate a unique link for each sketch, or a forum could create links based on user-submitted code snippets.
+
+>[!WARNING]
+> Be cautious when opening `pde://` links from unknown sources. Always review the contents of a sketch before running it, especially if it was shared by someone you don’t know. To protect your system, Processing runs downloaded sketches in a temporary folder, but you should still treat untrusted code with care.
+
 ## Local File Schema
 ```
 pde:///path/to/sketch.pde
@@ -60,4 +69,4 @@ Sets and saves multiple preferences in a single operation.
 - URL-based operations automatically prepend https:// if no scheme is provided
 - All URLs and query parameters are decoded using UTF-8
 - File downloads occur asynchronously in a separate thread
-- Base64 and remote sketches are saved to temporary folders
\ No newline at end of file
+- Base64 and remote sketches are saved to temporary folders