From 1633d31be3e0d19a8c869022741f05627c88671a Mon Sep 17 00:00:00 2001
From: Kenric Ashe <26514157+kenricashe@users.noreply.github.com>
Date: Fri, 25 Jul 2025 18:54:19 -0700
Subject: [PATCH 1/2] Update QueryExecute() Examples

---
 .../01.functions/queryexecute/_examples.md    | 74 +++++++++++--------
 docs/recipes/query-handling.md                | 14 ++--
 2 files changed, 49 insertions(+), 39 deletions(-)

diff --git a/docs/03.reference/01.functions/queryexecute/_examples.md b/docs/03.reference/01.functions/queryexecute/_examples.md
index 24a72d524..5a83af59a 100644
--- a/docs/03.reference/01.functions/queryexecute/_examples.md
+++ b/docs/03.reference/01.functions/queryexecute/_examples.md
@@ -2,43 +2,53 @@
 # SELECT
 
 ```luceescript+trycf
-    _test = queryNew(
-        "_id, _need, _forWorld",
-        "integer, varchar, varchar",
-        [[01,'plant', 'agri'],[02, 'save','water']]
-    );
-    queryResult = queryExecute(
-        sql = 'SELECT * FROM _test WHERE _need = :need',
-        params = {
-            need: {
-                value: "plant",
-                type: "varchar"
-            }
-        },
-        options = {
-            dbtype = 'query'
+_test = queryNew(
+    "_id, _need, _forWorld",
+    "integer, varchar, varchar",
+    [[01,'plant', 'agri'],[02, 'save','water']]
+);
+queryResult = QueryExecute(
+    sql = "SELECT * FROM _test WHERE _need = :need",
+    params = {
+        need: {
+            value: "plant",
+            type: "varchar"
         }
-    );
-    dump(queryResult);
+    },
+    options = {
+        dbtype = "query"
+    }
+);
+dump(queryResult);
 ```
 
 # INSERT
 
-and returning the generated key in result
-
 ```luceescript
-queryExecute(
-        sql = 'insert into user (name) values (:name)',
-        params = {
-            name: {
-                value: "lucee",
-                type: "varchar"
-            }
-        },
-        options = {
-            dbtype = 'query',
-            result: "insertResult"
+QueryExecute(
+    sql = "insert into user (name) values (:name)",
+    params = {
+        name: {
+            value: "lucee",
+            type: "varchar"
         }
-    );
-    dump( insertResult.generatedKey );
+    },
+    options = {
+        dbtype = "query",
+        // return the autoincrement generated key from database
+        result: "insertResult"
+    }
+);
+dump(insertResult.generatedKey);
+```
+
+Concise alternative with unnamed function arguments and removed optional dbtype:
+
+```luceescript
+QueryExecute(
+    "insert into user (name) values (:name)",
+    {"name": {"value": "lucee", "type": "varchar"}},
+    {"result": "insertResult"}
+);
+dump(insertResult.generatedKey);
 ```
diff --git a/docs/recipes/query-handling.md b/docs/recipes/query-handling.md
index 7b118e655..6b4348eaf 100644
--- a/docs/recipes/query-handling.md
+++ b/docs/recipes/query-handling.md
@@ -235,16 +235,16 @@ query name="result" datasource="myDB" sql="SELECT * FROM table" params=[];
 
 **Best for:** High-performance applications, legacy codebases, developers who prefer explicit control
 
-### 2. queryExecute - The Modern Alternative
+### 2. QueryExecute - The Modern Alternative
 
 **Syntax:**
 
-```javascript
-result = queryExecute(
-    sql: "SELECT * FROM users WHERE id = ?",
-    params: [123],
-    options: {
-        datasource: "myDB",
+```luceescript
+result = QueryExecute(
+    "SELECT * FROM users WHERE id = :id",
+    {id: {value: 123, type: "integer"}},
+    {
+        datasource: "myDB",  // if not configured globally
         returntype: "query"  // optional
     }
 );

From 4334c309a86698530ce5fbe161b67806907c0941 Mon Sep 17 00:00:00 2001
From: Lucee Docs GitHub Action <action@github.com>
Date: Sat, 26 Jul 2025 01:54:52 +0000
Subject: [PATCH 2/2] Update recipes index and README

---
 docs/recipes/index.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/recipes/index.json b/docs/recipes/index.json
index 8c9d5ee09..34bf40f2e 100644
--- a/docs/recipes/index.json
+++ b/docs/recipes/index.json
@@ -1080,7 +1080,7 @@
     "file": "query-handling.md",
     "title": "Query Execution",
     "path": "/docs/recipes/query-handling.md",
-    "hash": "27a215f080947142d2f2c2a05404e199",
+    "hash": "6c6cd8eb8788c6cb77b3270a2388559d",
     "keywords": [
       "cfquery",
       "queryExecute",