November docs housekeeping (#4597)

* clean up descriptions for bing

* fix broken third party links

docs/apis-tools/working-with-apis-tools.md

@@ -2,7 +2,7 @@
 id: working-with-apis-tools
 title: "Working with APIs & tools"
 sidebar_label: "Working with APIs & tools"
-description: "Learn more about the integration concepts involved in using the official Camunda Zeebe client libraries, APIs, and SDKs to interact programmatically with Camunda 8."
+description: "Learn more about the integration concepts involved in using the Camunda Zeebe client libraries, APIs, and SDKs to interact programmatically with Camunda 8."
 ---
 
 import DocCardList from '@theme/DocCardList';

docs/components/concepts/expressions.md

@@ -1,7 +1,7 @@
 ---
 id: expressions
 title: "Expressions"
-description: "Expressions can be used to access variables and calculate values dynamically."
+description: "Expressions can be used to access variables and calculate values dynamically. This is useful when automating a process using BPMN and orchestrating human tasks."
 ---
 
 Expressions can be used to access variables and calculate values dynamically.

docs/components/concepts/job-workers.md

@@ -1,7 +1,7 @@
 ---
 id: job-workers
 title: "Job workers"
-description: "A job worker is a service that can perform a particular task in a process. When this task needs to be performed, this is represented by a job."
+description: "Learn more about job workers, a service that can perform a particular task in a process. When this task needs to be performed, this is represented by a job."
 ---
 
 A **job worker** is a service capable of performing a particular task in a process. Each time such a task needs to be performed, this is represented by a **job**.

docs/components/concepts/variables.md

@@ -1,7 +1,7 @@
 ---
 id: variables
 title: "Variables"
-description: "Variables are part of a process instance and represent the data of the instance."
+description: "Variables are part of process instances and represent their data. Leverage the scope of variables and customize how they are merged into process instances."
 ---
 
 Variables are part of a process instance and represent the data of the instance.

docs/components/modeler/bpmn/exclusive-gateways/exclusive-gateways.md

@@ -1,7 +1,7 @@
 ---
 id: exclusive-gateways
 title: "Exclusive gateway"
-description: "An exclusive gateway (or XOR-gateway) allows you to make a decision based on data."
+description: "Learn more about exclusive gateways (or XOR-gateways) and their conditions, which allow you to make a decision based on data such as process instance variables."
 ---
 
 An exclusive gateway (or XOR-gateway) allows you to make a decision based on data (i.e. on process instance variables).

docs/components/modeler/bpmn/inclusive-gateways/inclusive-gateways.md

@@ -1,10 +1,10 @@
 ---
 id: inclusive-gateways
 title: "Inclusive gateway"
-description: "An inclusive gateway (or OR-gateway) allows you to make multiple decisions based on data."
+description: "Learn more about inclusive gateways, which allow for making multiple decisions based on data or process instance variables, and can be diverging or converging."
 ---
 
-The inclusive gateway (or OR-gateway) allows for making multiple decisions based on data, or process instance variables. Inclusive gateways can be diverging (a sequence flow is split into multiple paths) or converging (split paths are merged before continuing).
+The inclusive gateway (or OR-gateway) allows for making multiple decisions based on data or process instance variables. Inclusive gateways can be diverging (a sequence flow is split into multiple paths) or converging (split paths are merged before continuing).
 
 ![A process model to prepare lunch at lunchtime can use an inclusive gateway to decide which steps to take to prepare the different lunch components, e.g. cook pasta,stir-fry steak, prepare salad, or any combination of these.](assets/inclusive-gateway.png)
 

docs/components/modeler/bpmn/multi-instance/multi-instance.md

@@ -1,7 +1,7 @@
 ---
 id: multi-instance
 title: "Multi-instance"
-description: "A multi-instance activity is executed multiple times - once for each element of a given collection."
+description: "Learn about multi-instance activities like service tasks and receive tasks. These can be executed multiple times - once for each element of a given collection."
 ---
 
 A multi-instance activity is executed multiple times - once for each element of a given collection (like a _foreach_ loop in a programming language).

docs/components/modeler/bpmn/service-tasks/service-tasks.md

@@ -1,7 +1,7 @@
 ---
 id: service-tasks
 title: "Service tasks"
-description: "A service task represents a work item in the process with a specific type."
+description: "Learn more about service tasks which represent a work item in the process with a specific type. When a service task is entered, a corresponding job is created."
 ---
 
 A service task represents a work item in the process with a specific type.

docs/components/modeler/bpmn/timer-events/timer-events.md

@@ -1,7 +1,7 @@
 ---
 id: timer-events
 title: "Timer events"
-description: "Timer events are events triggered by a defined timer, including timer start events, intermediate timer catch events, and interrupting/non-interrupting timer boundary events."
+description: "Learn about events triggered by a timer, including timer start events, intermediate timer catch events, and interrupting/non-interrupting timer boundary events."
 ---
 
 Timer events are events triggered by a defined timer.

docs/components/modeler/desktop-modeler/install-the-modeler.md

@@ -2,7 +2,7 @@
 id: install-the-modeler
 title: Install Desktop Modeler
 sidebar_label: Installation
-description: "Learn how to install Camunda Desktop Modeler."
+description: "Learn how to install Camunda Desktop Modeler, a desktop application for modeling BPMN, DMN, and Forms and support building executable diagrams with Camunda."
 ---
 
 Download [Desktop Modeler](./index.md) for Windows, macOS, and Linux from the [Camunda downloads page](https://camunda.com/download/modeler/).

docs/components/modeler/forms/form-element-library/forms-element-library-button.md

@@ -15,4 +15,4 @@ A button allowing the user to trigger form actions.
   - **Submit**: Submit the form (given there are no validation errors).
   - **Reset**: Reset the form, all user inputs will be lost.
 - **Hide if**: [Expression](../../feel/language-guide/feel-expressions-introduction.md) to hide the button.
-- **Columns**: Space the button will use inside its row. **Auto** means it will automatically adjust to available space in the row. Read more about the underlying grid layout in the [Carbon Grid documentation](https://carbondesignsystem.com/guidelines/2x-grid/overview).
+- **Columns**: Space the button will use inside its row. **Auto** means it will automatically adjust to available space in the row. Read more about the underlying grid layout in the [Carbon Grid documentation](https://carbondesignsystem.com/elements/2x-grid/overview/).

docs/components/modeler/forms/form-element-library/forms-element-library-checkbox-group.md

@@ -19,7 +19,7 @@ A set of checkbox options providing data multi-selection for small datasets.
 - **Hide if**: [Expression](../../feel/language-guide/feel-expressions-introduction.md) to hide the checkbox group.
 - **Validation**: Given that one of the following properties is set, the form will only submit when the respective condition is fulfilled. Otherwise, a validation error will be displayed.
   - **Required**: Checkbox group must contain a value.
-- **Columns**: Space the field will use inside its row. **Auto** means it will automatically adjust to available space in the row. Read more about the underlying grid layout in the [Carbon Grid documentation](https://carbondesignsystem.com/guidelines/2x-grid/overview).
+- **Columns**: Space the field will use inside its row. **Auto** means it will automatically adjust to available space in the row. Read more about the underlying grid layout in the [Carbon Grid documentation](https://carbondesignsystem.com/elements/2x-grid/overview/).
 
 ### Datatypes
 

docs/components/modeler/forms/form-element-library/forms-element-library-checkbox.md

@@ -19,7 +19,7 @@ A checkbox allowing the user to read and edit boolean data.
 - **Hide if**: [Expression](../../feel/language-guide/feel-expressions-introduction.md) to hide the checkbox.
 - **Validation**: Given that one of the following properties is set, the form will only submit when the respective condition is fulfilled. Otherwise, a validation error will be displayed.
   - **Required**: Checkbox must contain a value.
-- **Columns**: Space the field will use inside its row. **Auto** means it will automatically adjust to available space in the row. Read more about the underlying grid layout in the [Carbon Grid documentation](https://carbondesignsystem.com/guidelines/2x-grid/overview).
+- **Columns**: Space the field will use inside its row. **Auto** means it will automatically adjust to available space in the row. Read more about the underlying grid layout in the [Carbon Grid documentation](https://carbondesignsystem.com/elements/2x-grid/overview/).
 
 ### Datatypes
 

docs/components/modeler/forms/form-element-library/forms-element-library-datetime.md

@@ -19,7 +19,7 @@ A component allowing the user to read and edit date and time data.
 - **Read only**: Makes the datetime component read-only, meaning the user can't change but only read its state. Can be dynamically set using an [expression](../../feel/language-guide/feel-expressions-introduction.md).
 - **Disabled**: Disables the datetime component, for use during development.
 - **Hide if**: [Expression](../../feel/language-guide/feel-expressions-introduction.md) to hide the datetime component.
-- **Columns**: Space the field will use inside its row. **Auto** means it will automatically adjust to available space in the row. Read more about the underlying grid layout in the [Carbon Grid documentation](https://carbondesignsystem.com/guidelines/2x-grid/overview).
+- **Columns**: Space the field will use inside its row. **Auto** means it will automatically adjust to available space in the row. Read more about the underlying grid layout in the [Carbon Grid documentation](https://carbondesignsystem.com/elements/2x-grid/overview/).
 - **Time format**: Defines the time data format. This can either be **UTC offset**, **UTC normalized**, or **No timezone**.
 - **Time interval**: Defines the steps of time that can be selected in the time input field.
 - **Disallow past dates**: Enables the restriction to not allow past dates.

docs/components/modeler/forms/form-element-library/forms-element-library-expression.md

@@ -14,7 +14,7 @@ An expression field allowing the user to compute new data based on form state.
 - **Target value**: Defines an [expression](../../feel/language-guide/feel-expressions-introduction.md) to evaluate.
 - **Compute on**: Defines when the expression should be evaluated. Either whenever the result changes, or only on form submission.
 - **Deactivate if**: [Expression](../../feel/language-guide/feel-expressions-introduction.md) to disable the expression.
-- **Columns**: Space the field will use inside its row. **Auto** means it will automatically adjust to available space in the row. Read more about the underlying grid layout in the [Carbon Grid documentation](https://carbondesignsystem.com/guidelines/2x-grid/overview).
+- **Columns**: Space the field will use inside its row. **Auto** means it will automatically adjust to available space in the row. Read more about the underlying grid layout in the [Carbon Grid documentation](https://carbondesignsystem.com/elements/2x-grid/overview/).
 
 :::info
 

docs/components/modeler/forms/form-element-library/forms-element-library-filepicker.md

@@ -17,6 +17,6 @@ A form element to select files.
 - **Read only**: Makes the file picker read-only, meaning the user can't change but only read its state. Can be dynamically set using an [expression](../../feel/language-guide/feel-expressions-introduction.md).
 - **Disabled**: Disables the file picker, for use during development.
 - **Hide if**: [Expression](../../feel/language-guide/feel-expressions-introduction.md) to hide the file picker.
-- **Columns**: Space the field will use inside its row. **Auto** means it will automatically adjust to available space in the row. Read more about the underlying grid layout in the [Carbon Grid documentation](https://carbondesignsystem.com/guidelines/2x-grid/overview).
+- **Columns**: Space the field will use inside its row. **Auto** means it will automatically adjust to available space in the row. Read more about the underlying grid layout in the [Carbon Grid documentation](https://carbondesignsystem.com/elements/2x-grid/overview/).
 - **Validation**: Given that one of the following properties is set, the form will only submit when the respective condition is fulfilled. Otherwise, a validation error will be displayed.
   - **Required**: File picker must have a selected file.

docs/components/modeler/forms/form-element-library/forms-element-library-group.md

@@ -15,7 +15,7 @@ The group element serves as a container to group various form elements together.
 - **Show outline**: Can be toggled on and off to display a separating outline around the group
 - **Vertical alignment**: Determines the alignment of items in the list.
 - **Hide if**: [Expression](../../feel/language-guide/feel-expressions-introduction.md) to hide the group.
-- **Columns**: Space the field will use inside its row. **Auto** means it will automatically adjust to available space in the row. Read more about the underlying grid layout in the [Carbon Grid documentation](https://carbondesignsystem.com/guidelines/2x-grid/overview).
+- **Columns**: Space the field will use inside its row. **Auto** means it will automatically adjust to available space in the row. Read more about the underlying grid layout in the [Carbon Grid documentation](https://carbondesignsystem.com/elements/2x-grid/overview/).
 
 ### Usage
 

docs/components/modeler/forms/form-element-library/forms-element-library-html.md

@@ -12,7 +12,7 @@ A flexible display component designed to quickly render HTML content for the use
 
 - **Content**: This property accepts HTML content. Define it using [templating syntax](../configuration/forms-config-templating-syntax.md) or as plaintext HTML. The rendered content is sanitized for security reasons, see below for details.
 - **Hide if**: [Expression](../../feel/language-guide/feel-expressions-introduction.md) to conditionally hide the HTML content.
-- **Columns**: Space the field will use inside its row. The **Auto** means it will automatically adjust to available space in the row. Read more about the underlying grid layout in the [Carbon Grid documentation](https://carbondesignsystem.com/guidelines/2x-grid/overview).
+- **Columns**: Space the field will use inside its row. The **Auto** means it will automatically adjust to available space in the row. Read more about the underlying grid layout in the [Carbon Grid documentation](https://carbondesignsystem.com/elements/2x-grid/overview/).
 
 ## Our security and sanitation strategy
 

docs/components/modeler/forms/form-element-library/forms-element-library-iframe.md

@@ -30,7 +30,7 @@ Every iframe component is a sandbox. This means that the content of the iframe i
   - **Top level navigation**: Gives the iframe permission to change the URL of the parent page, navigating away entirely from it.
   - **Storage access by user**: Controls access of local storage based on user interactions, may be expected in addition to allow same origin on certain browsers for functionality depending on storage.
 - **Hide if**: [Expression](../../feel/language-guide/feel-expressions-introduction.md) to hide the iframe.
-- **Columns**: Space the field will use inside its row. **Auto** means it will automatically adjust to available space in the row. Read more about the underlying grid layout in the [Carbon Grid documentation](https://carbondesignsystem.com/guidelines/2x-grid/overview).
+- **Columns**: Space the field will use inside its row. **Auto** means it will automatically adjust to available space in the row. Read more about the underlying grid layout in the [Carbon Grid documentation](https://carbondesignsystem.com/elements/2x-grid/overview/).
 
 ## Security advisory
 

docs/components/modeler/forms/form-element-library/forms-element-library-image.md

@@ -13,4 +13,4 @@ An element allowing the user to display images.
 - **Image source**: Specifies the image source via [expression](../../feel/language-guide/feel-expressions-introduction.md), [templating syntax](../configuration/forms-config-templating-syntax.md) or [static value](/components/concepts/expressions.md#expressions-vs-static-values) (hyperlink or data URI).
 - **Alternative text**: Provides an alternative text to the image in case it cannot be displayed. Can either be an [expression](../../feel/language-guide/feel-expressions-introduction.md), plain text, or [templating syntax](../configuration/forms-config-templating-syntax.md).
 - **Hide if**: [Expression](../../feel/language-guide/feel-expressions-introduction.md) to hide the image.
-- **Columns**: Space the field will use inside its row. **Auto** means it will automatically adjust to available space in the row. Read more about the underlying grid layout in the [Carbon Grid documentation](https://carbondesignsystem.com/guidelines/2x-grid/overview).
+- **Columns**: Space the field will use inside its row. **Auto** means it will automatically adjust to available space in the row. Read more about the underlying grid layout in the [Carbon Grid documentation](https://carbondesignsystem.com/elements/2x-grid/overview/).

docs/components/modeler/forms/form-element-library/forms-element-library-number.md

@@ -19,7 +19,7 @@ A number field allowing the user to read and edit numeric data.
 - **Read only**: Makes the number field read-only, meaning the user can't change but only read its state. Can be dynamically set using an [expression](../../feel/language-guide/feel-expressions-introduction.md).
 - **Disabled**: Disables the number field, for use during development.
 - **Hide if**: [Expression](../../feel/language-guide/feel-expressions-introduction.md) to hide the number.
-- **Columns**: Space the field will use inside its row. **Auto** means it will automatically adjust to available space in the row. Read more about the underlying grid layout in the [Carbon Grid documentation](https://carbondesignsystem.com/guidelines/2x-grid/overview).
+- **Columns**: Space the field will use inside its row. **Auto** means it will automatically adjust to available space in the row. Read more about the underlying grid layout in the [Carbon Grid documentation](https://carbondesignsystem.com/elements/2x-grid/overview/).
 - **Serialize to string**: Configures the output format of the datetime value. This enables unlimited precision digits.
 - **Validation**: Given that one of the following properties is set, the form will only submit when the respective condition is fulfilled. Otherwise, a validation error will be displayed.
   - **Required**: Number field must contain a value.

docs/components/modeler/forms/form-element-library/forms-element-library-radio.md

@@ -18,7 +18,7 @@ A radio group allowing the user to select one of multiple data options for small
 - **Disabled**: Disables the radio group, for use during development.
 - **Options source**: Radio group components can be configured with an options source defining the individual choices the component provides, refer to [options source docs](../configuration/forms-config-options.md).
 - **Hide if**: [Expression](../../feel/language-guide/feel-expressions-introduction.md) to hide the radio group.
-- **Columns**: Space the field will use inside its row. **Auto** means it will automatically adjust to available space in the row. Read more about the underlying grid layout in the [Carbon Grid documentation](https://carbondesignsystem.com/guidelines/2x-grid/overview).
+- **Columns**: Space the field will use inside its row. **Auto** means it will automatically adjust to available space in the row. Read more about the underlying grid layout in the [Carbon Grid documentation](https://carbondesignsystem.com/elements/2x-grid/overview/).
 - **Validation**: Given that one of the following properties is set, the form will only submit when the respective condition is fulfilled. Otherwise, a validation error will be displayed.
   - **Required**: One radio option must be selected.
 

docs/components/modeler/forms/form-element-library/forms-element-library-select.md

@@ -18,7 +18,7 @@ A Select dropdown allowing the user to select one of multiple data option from l
 - **Read only**: Makes the select read-only, meaning the user can't change but only read its state. Can be dynamically set using an [expression](../../feel/language-guide/feel-expressions-introduction.md).
 - **Disabled**: Disables the select, for use during development.
 - **Hide if**: [Expression](../../feel/language-guide/feel-expressions-introduction.md) to hide the select.
-- **Columns**: Space the field will use inside its row. **Auto** means it will automatically adjust to available space in the row. Read more about the underlying grid layout in the [Carbon Grid documentation](https://carbondesignsystem.com/guidelines/2x-grid/overview).
+- **Columns**: Space the field will use inside its row. **Auto** means it will automatically adjust to available space in the row. Read more about the underlying grid layout in the [Carbon Grid documentation](https://carbondesignsystem.com/elements/2x-grid/overview/).
 - **Options source**: Selects can be configured with an options source defining the individual choices the select provides, refer to [options source docs](../configuration/forms-config-options.md).
 - **Validation**: Given that one of the following properties is set, the form will only submit when the respective condition is fulfilled. Otherwise, a validation error will be displayed.
   - **Required**: One select entry must be selected.