update quartz docs

Author: michaeloffner

docs/recipes/scheduler-quartz-clustering.md

@@ -27,6 +27,8 @@ This recipe provides detailed instructions for setting up and configuring cluste
 
 For a general overview of the Quartz Scheduler extension, see the [Quartz Scheduler documentation](https://github.com/lucee/lucee-docs/blob/master/docs/recipes/scheduler-quartz.md).
 
+**Prerequisites:** Before configuring clustering, you must first install the Quartz Scheduler extension and configure a gateway instance. See the [Gateway Configuration](scheduler-quartz.md#gateway-configuration-required) section in the main Quartz Scheduler documentation.
+
 ## Overview
 
 Clustering in Quartz Scheduler allows you to distribute your scheduled tasks across multiple servers, providing:

docs/recipes/scheduler-quartz-component-jobs.md

@@ -22,6 +22,8 @@ Execute CFML components (CFCs) as scheduled tasks with Quartz Scheduler.
 
 For general overview, see [[scheduler-quartz]].
 
+**Prerequisites:** Before creating component-based jobs, you must first install the Quartz Scheduler extension and configure a gateway instance. See the [Gateway Configuration](scheduler-quartz.md#gateway-configuration-required) section in the main Quartz Scheduler documentation.
+
 Advantages over URL-based jobs:
 
 - Full CFML capabilities

docs/recipes/scheduler-quartz.md

@@ -47,6 +47,26 @@ During this transition period, the legacy Scheduled Task extension is installed
 - **JSON Configuration**: Define your tasks using flexible JSON configuration
 - **Component Integration**: Execute CFML components as scheduled tasks with dependency injection
 
+## Version Changes (v1.1.0+)
+
+**Important:** Version 1.1.0 introduces a breaking change from v1.0.x:
+
+| Feature | v1.0.x | v1.1.0+ |
+|---------|--------|---------|
+| Auto-creates gateway instance | ✅ Yes | ❌ No |
+| Manual gateway configuration | ❌ Not needed | ✅ Required |
+| Jobs work immediately after install | ✅ Yes | ❌ No (must configure gateway) |
+| Existing jobs/configs compatible | N/A | ✅ Yes |
+
+**If upgrading from v1.0:**
+Your existing jobs and configurations will continue to work, but you must manually configure a gateway instance (see [Gateway Configuration](#gateway-configuration-required) below).
+
+**Why this change?**
+- Provides more control over scheduler initialization
+- Allows installing the extension without automatically starting the scheduler
+- Better supports configuration-as-code approaches
+- Enables cleaner separation of concerns
+
 ## Installation
 
 The Quartz Scheduler extension can be installed in two ways:
@@ -67,6 +87,43 @@ In Lucee 6.2, this extension is considered experimental, primarily for testing p
 
 In Lucee 7, it's fully supported as an alternative to the legacy Scheduled Task system.
 
+## Gateway Configuration (Required)
+
+**Important:** Installing the extension does NOT automatically start a Quartz instance. You must manually configure a gateway instance for the scheduler to work.
+
+### Using the Lucee Administrator
+
+1. Navigate to **Server > Event Gateways > Gateway Instances**
+2. Click **Create New Instance**
+3. Select **Quartz Scheduler** from the gateway type dropdown
+4. Set the Instance ID to `quartz-task`
+5. Enable "Startup Mode" and set it to **Automatic**
+6. Under custom settings, configure:
+   - `configFile`: `{lucee-config}/quartz/config.json`
+   - `scheduler`: `scheduler`
+7. Click **Save**
+
+### Using .CFConfig.json
+
+Add the following to your `.CFConfig.json`:
+
+```json
+{
+  "gateways": {
+    "quartz-task": {
+      "cfcPath": "org.lucee.extension.quartz.QuartzGateway",
+      "listenerCFCPath": "",
+      "startupMode": "automatic",
+      "custom": {
+        "configFile": "{lucee-config}/quartz/config.json",
+        "scheduler": "scheduler"
+      },
+      "readOnly": "false"
+    }
+  }
+}
+```
+
 ## Administration
 
 The Quartz Scheduler extension provides comprehensive administration tools to manage your scheduled tasks: