Update Desktop Modeler connector template documentation

docs/components/modeler/desktop-modeler/flags/flags.md

@@ -30,26 +30,26 @@ Flags passed as command line arguments take precedence over those configured via
 
 ## Available flags
 
-| flag                                                        | default value                       |
-| ----------------------------------------------------------- | ----------------------------------- |
-| ["disable-plugins"](#disable-plug-ins)                      | false                               |
-| "disable-adjust-origin"                                     | false                               |
-| "disable-cmmn"                                              | true                                |
-| "disable-dmn"                                               | false                               |
-| "disable-form"                                              | false                               |
-| ["disable-httl-hint"](#disable-history-time-to-live-hint)   | false                               |
-| ["default-httl"](#default-history-time-to-live)             | false                               |
-| "disable-platform"                                          | false                               |
-| "disable-zeebe"                                             | false                               |
-| "disable-remote-interaction"                                | false                               |
-| "single-instance"                                           | false                               |
-| "user-data-dir"                                             | [Electron default](../search-paths) |
-| ["display-version"](#custom-display-version-label)          | `undefined`                         |
-| ["zeebe-ssl-certificate"](#zeebe-ssl-certificate)           | `undefined`                         |
-| ["c7-engine-version"](#default-execution-platform-version)  | `undefined`                         |
-| ["c8-engine-version"](#default-execution-platform-version)  | `undefined`                         |
-| ["enable-new-context-pad"](#enable-new-context-pad)         | `false`                             |
-| ["enable-connector-templates"](#enable-connector-templates) | `false`                             |
+| flag                                                          | default value                       |
+| ------------------------------------------------------------- | ----------------------------------- |
+| ["disable-plugins"](#disable-plug-ins)                        | false                               |
+| "disable-adjust-origin"                                       | false                               |
+| "disable-cmmn"                                                | true                                |
+| "disable-dmn"                                                 | false                               |
+| "disable-form"                                                | false                               |
+| ["disable-httl-hint"](#disable-history-time-to-live-hint)     | false                               |
+| ["default-httl"](#default-history-time-to-live)               | false                               |
+| "disable-platform"                                            | false                               |
+| "disable-zeebe"                                               | false                               |
+| "disable-remote-interaction"                                  | false                               |
+| "single-instance"                                             | false                               |
+| "user-data-dir"                                               | [Electron default](../search-paths) |
+| ["display-version"](#custom-display-version-label)            | `undefined`                         |
+| ["zeebe-ssl-certificate"](#zeebe-ssl-certificate)             | `undefined`                         |
+| ["c7-engine-version"](#default-execution-platform-version)    | `undefined`                         |
+| ["c8-engine-version"](#default-execution-platform-version)    | `undefined`                         |
+| ["enable-new-context-pad"](#enable-new-context-pad)           | `false`                             |
+| ["disable-connector-templates"](#disable-connector-templates) | `false`                             |
 
 ## Examples
 
@@ -153,14 +153,14 @@ To use the new context pad, configure your `flags.json` as follows:
 
 ![New context pad](./img/new-context-pad.png)
 
-### Enable Connector templates
+### Disable Connector templates
 
-To enable the automatic fetching of Camunda 8 Connector templates, configure your `flags.json` as follows:
+<span class="badge badge--cloud">Camunda 8 only</span>
+
+To [disable automatic Connector template fetching](../use-connectors.md#automatic-connector-template-fetching), configure your `flags.json` as follows:
 
 ```json
 {
-  "enable-connector-templates": true
+  "enable-connector-templates": false
 }
 ```
-
-[Learn more about using Connectors](../use-connectors.md).

docs/components/modeler/desktop-modeler/use-connectors.md

@@ -6,13 +6,16 @@ description: "Learn how to use Camunda 8 Connectors in Desktop Modeler."
 
 <span class="badge badge--cloud">Camunda 8 only</span>
 
-To use [Camunda 8 Connectors](../../connectors/out-of-the-box-connectors/available-connectors-overview.md) in Desktop Modeler, enable [automatic fetching](#fetch-camunda-8-connector-templates-automatically) of the respective Connector templates. Alternatively, for greater control, you may [fetch and configure templates manually](#add-camunda-8-connector-templates-manually).
+Use [Camunda 8 Connectors](../../connectors/introduction.md) to access a growing range of external services or communication protocols.
 
-## Fetch Camunda 8 Connector templates automatically
+The Desktop Modeler fetches templates for [pre-built Connectors](../../connectors/out-of-the-box-connectors/available-connectors-overview.md) [automatically](#automatic-connector-template-fetching) and makes them available for use in your Camunda 8 BPMN processes.
+You can [disable this feature](#disable-automatic-connector-template-fetching) and [provide Connector templates manually](#add-connector-templates-manually) for full control over the building blocks the modeler should offer.
 
-You can enable automatic fetching of Connector templates for [Camunda 8 Connectors](../../connectors/out-of-the-box-connectors/available-connectors-overview.md) through the [`enable-connector-templates` flag](./flags/flags.md#enable-connector-templates). Once set, it will fetch Camunda 8 Connector templates in the background and you'll be able to use them in your BPMN diagrams.
+## Automatic Connector template fetching
 
-On startup, a notification indicates if the templates are up to date or have been updated:
+The modeler fetches and updates templates for [pre-built Camunda connectors](../../connectors/out-of-the-box-connectors/available-connectors-overview.md) periodically [from the Camunda Marketplace](https://marketplace.camunda.com/en-US/listing?pl=3038&attr=20486&cat=107792&locale=en-US). This happens automatically, in the background, unless you [explicitly disable it](#disable-automatic-connector-template-fetching).
+
+After an update check concluded, a notification indicates if the templates are up to date or have been updated:
 
 ![Camunda Connector templates up to date notification](./img/use-connectors/up-to-date.png)
 
@@ -24,11 +27,15 @@ Once fetched, you can use the templates in the Camunda 8 BPMN editor.
 
 ![Using Camunda Connector templates in the Camunda 8 BPMN editor](./img/use-connectors/apply.png)
 
-## Add Camunda 8 Connector templates manually
+## Disable automatic Connector template fetching
+
+Disable automatic fetching of Connector templates through the [respective flag](./flags/flags.md#disable-connector-templates).
+
+## Add Connector templates manually
 
-For greater control, you can download individual Camunda 8 Connector templates manually through the [Camunda Marketplace website](https://marketplace.camunda.com/) and make them available in Desktop Modeler via the [standard element template search paths](./element-templates/configuring-templates.md).
+For full control over building blocks offered by the Desktop Modeler, download templates for individual Camunda 8 Connectors manually, i.e. through the [Camunda Marketplace](https://marketplace.camunda.com/). Make them available to the Desktop Modeler via the [standard element template search paths](./element-templates/configuring-templates.md).
 
 ## Additional resources
 
-- [Learn about Camunda 8 Connectors](../../connectors/out-of-the-box-connectors/available-connectors-overview.md)
-- [Desktop Modeler flags](./flags/flags.md)
+- [About Camunda 8 Connectors](../../connectors/out-of-the-box-connectors/available-connectors-overview.md)
+- [Desktop Modeler flags](./flags/flags.md#enable-connector-templates)

versioned_docs/version-8.5/components/modeler/desktop-modeler/flags/flags.md

@@ -30,25 +30,26 @@ Flags passed as command line arguments take precedence over those configured via
 
 ## Available flags
 
-| flag                                                       | default value                       |
-| ---------------------------------------------------------- | ----------------------------------- |
-| ["disable-plugins"](#disable-plug-ins)                     | false                               |
-| "disable-adjust-origin"                                    | false                               |
-| "disable-cmmn"                                             | true                                |
-| "disable-dmn"                                              | false                               |
-| "disable-form"                                             | false                               |
-| ["disable-httl-hint"](#disable-history-time-to-live-hint)  | false                               |
-| ["default-httl"](#default-history-time-to-live)            | false                               |
-| "disable-platform"                                         | false                               |
-| "disable-zeebe"                                            | false                               |
-| "disable-remote-interaction"                               | false                               |
-| "single-instance"                                          | false                               |
-| "user-data-dir"                                            | [Electron default](../search-paths) |
-| ["display-version"](#custom-display-version-label)         | `undefined`                         |
-| ["zeebe-ssl-certificate"](#zeebe-ssl-certificate)          | `undefined`                         |
-| ["c7-engine-version"](#default-execution-platform-version) | `undefined`                         |
-| ["c8-engine-version"](#default-execution-platform-version) | `undefined`                         |
-| ["enable-new-context-pad"](#enable-new-context-pad)        | `false`                             |
+| flag                                                          | default value                       |
+| ------------------------------------------------------------- | ----------------------------------- |
+| ["disable-plugins"](#disable-plug-ins)                        | false                               |
+| "disable-adjust-origin"                                       | false                               |
+| "disable-cmmn"                                                | true                                |
+| "disable-dmn"                                                 | false                               |
+| "disable-form"                                                | false                               |
+| ["disable-httl-hint"](#disable-history-time-to-live-hint)     | false                               |
+| ["default-httl"](#default-history-time-to-live)               | false                               |
+| "disable-platform"                                            | false                               |
+| "disable-zeebe"                                               | false                               |
+| "disable-remote-interaction"                                  | false                               |
+| "single-instance"                                             | false                               |
+| "user-data-dir"                                               | [Electron default](../search-paths) |
+| ["display-version"](#custom-display-version-label)            | `undefined`                         |
+| ["zeebe-ssl-certificate"](#zeebe-ssl-certificate)             | `undefined`                         |
+| ["c7-engine-version"](#default-execution-platform-version)    | `undefined`                         |
+| ["c8-engine-version"](#default-execution-platform-version)    | `undefined`                         |
+| ["enable-new-context-pad"](#enable-new-context-pad)           | `false`                             |
+| ["disable-connector-templates"](#disable-connector-templates) | `false`                             |
 
 ## Examples
 
@@ -151,3 +152,15 @@ To use the new context pad, configure your `flags.json` as follows:
 ```
 
 ![New context pad](./img/new-context-pad.png)
+
+### Disable Connector templates
+
+<span class="badge badge--cloud">Camunda 8 only</span>
+
+To [disable automatic Connector template fetching](../use-connectors.md#automatic-connector-template-fetching), configure your `flags.json` as follows:
+
+```json
+{
+  "enable-connector-templates": false
+}
+```

versioned_docs/version-8.5/components/modeler/desktop-modeler/use-connectors.md

@@ -0,0 +1,41 @@
+---
+id: use-connectors
+title: Use Connectors
+description: "Learn how to use Camunda 8 Connectors in Desktop Modeler."
+---
+
+<span class="badge badge--cloud">Camunda 8 only</span>
+
+Use [Camunda 8 Connectors](../../connectors/introduction.md) to access a growing range of external services or communication protocols.
+
+The Desktop Modeler fetches templates for [pre-built Connectors](../../connectors/out-of-the-box-connectors/available-connectors-overview.md) [automatically](#automatic-connector-template-fetching) and makes them available for use in your Camunda 8 BPMN processes.
+You can [disable this feature](#disable-automatic-connector-template-fetching) and [provide Connector templates manually](#add-connector-templates-manually) for full control over the building blocks the modeler should offer.
+
+## Automatic Connector template fetching
+
+The modeler fetches and updates templates for [pre-built Camunda connectors](../../connectors/out-of-the-box-connectors/available-connectors-overview.md) periodically [from the Camunda Marketplace](https://marketplace.camunda.com/en-US/listing?pl=3038&attr=20486&cat=107792&locale=en-US). This happens automatically, in the background, unless you [explicitly disable it](#disable-automatic-connector-template-fetching).
+
+After an update check concluded, a notification indicates if the templates are up to date or have been updated:
+
+![Camunda Connector templates up to date notification](./img/use-connectors/up-to-date.png)
+
+In case of an error you'll see a nofication:
+
+![Error updating Camunda Connector templates notification](./img/use-connectors/error.png)
+
+Once fetched, you can use the templates in the Camunda 8 BPMN editor.
+
+![Using Camunda Connector templates in the Camunda 8 BPMN editor](./img/use-connectors/apply.png)
+
+## Disable automatic Connector template fetching
+
+Disable automatic fetching of Connector templates through the [respective flag](./flags/flags.md#disable-connector-templates).
+
+## Add Connector templates manually
+
+For full control over building blocks offered by the Desktop Modeler, download templates for individual Camunda 8 Connectors manually, i.e. through the [Camunda Marketplace](https://marketplace.camunda.com/). Make them available to the Desktop Modeler via the [standard element template search paths](./element-templates/configuring-templates.md).
+
+## Additional resources
+
+- [About Camunda 8 Connectors](../../connectors/out-of-the-box-connectors/available-connectors-overview.md)
+- [Desktop Modeler flags](./flags/flags.md#enable-connector-templates)

versioned_sidebars/version-8.5-sidebars.json

@@ -176,6 +176,7 @@
             "components/modeler/desktop-modeler/model-your-first-diagram",
             "components/modeler/desktop-modeler/connect-to-camunda-8",
             "components/modeler/desktop-modeler/start-instance",
+            "components/modeler/desktop-modeler/use-connectors",
             {
               "type": "category",
               "label": "Element templates",