Merge pull request #290827 from mumian/1112-spread

Improve the spread function article.

Author: prmerger-automator[bot]

articles/azure-resource-manager/bicep/bicep-functions.md

@@ -98,7 +98,7 @@ The following functions are available for working with lambda expressions. All o
 * [sort](bicep-functions-lambda.md#sort)
 * [toObject](bicep-functions-lambda.md#toobject)
 
-## Logical functions
+## Logical function
 
 The following function is available for working with logical conditions. This function is in the `sys` namespace.
 

articles/azure-resource-manager/bicep/data-types.md

@@ -3,25 +3,13 @@ title: Data types in Bicep
 description: This article describes the data types that are available in Bicep.
 ms.topic: reference
 ms.custom: devx-track-bicep
-ms.date: 08/20/2024
+ms.date: 11/12/2024
 ---
 
 # Data types in Bicep
 
 This article describes the data types that are supported in [Bicep](./overview.md). To define custom data types, see [User-defined data types](./user-defined-data-types.md).
 
-## Supported types
-
-Within Bicep, you can use these data types:
-
-* [array](#arrays)
-* [bool](#booleans)
-* [int](#integers)
-* [object](#objects)
-* [secureObject (indicated by a decorator in Bicep](#secure-strings-and-objects))
-* [secureString (indicated by a decorator in Bicep](#secure-strings-and-objects))
-* [string](#strings)
-
 ## Arrays
 
 Arrays start with a left bracket (`[`) and end with a right bracket (`]`). In Bicep, you can declare an array in a single line or in multiple lines. Commas (`,`) are used between values in single-line declarations, but they aren't used in multiple-line declarations. You can mix and match single-line and multiple-line declarations. The multiple-line declaration requires [Bicep CLI version 0.7.X or higher](./install.md).
@@ -86,6 +74,18 @@ output foo bool = empty(emptyArray) || emptyArray[0] == 'bar'
 output bar bool = length(numberArray) <= 3 || numberArray[3] == 4
 ```
 
+### Array-related operators
+
+* Use [Comparison operators](./operators-comparison.md) to compare two arrays.
+* Use [Index accessor](./operators-access.md#index-accessor) to get an element from an array.
+* Use [Safe-dereference operator](./operator-safe-dereference.md) to access elements of an array.
+* Use [Spread](./operator-spread.md) to merge arrays.
+
+### Array-related functions
+
+* See [Array functions](./bicep-functions-array.md).
+* See [Lambda functions](./bicep-functions-lambda.md).
+
 ## Booleans
 
 When you specify Boolean values, use `true` or `false`. Don't surround the value with quotation marks.
@@ -94,6 +94,15 @@ When you specify Boolean values, use `true` or `false`. Don't surround the value
 param exampleBool bool = true
 ```
 
+## Boolean-related operators
+
+* Use [Comparison operators](./operators-comparison.md) to compare boolean values.
+* See [Logical operators](./operators-logical.md).
+
+## Boolean-related functions
+
+See [Logical function](./bicep-functions-logical.md)
+
 ## Integers
 
 When you specify integer values, don't use quotation marks.
@@ -129,6 +138,15 @@ output bar 1 | 2 | 3 = 3
 
 Floating point, decimal, or binary formats aren't currently supported.
 
+### Integer-related operators
+
+* See [Comparison operators](./operators-comparison.md).
+* See [Numeric operators](./operators-numeric.md).
+
+### Integer-related functions
+
+See [Numeric functions](./bicep-functions-numeric.md).
+
 ## Objects
 
 Objects start with a left brace (`{`) and end with a right brace (`}`). In Bicep, you can declare an object in a single line or in multiple lines. Each property in an object consists of a key and a value. The key and value are separated by a colon (`:`). An object allows any property of any type. Commas (`,`) are used between properties for single-line declarations, but they aren't used between properties for multiple-line declarations. You can mix and match single-line and multiple-line declarations. The multiple-line declaration requires [Bicep CLI version 0.7.X or higher](./install.md).
@@ -217,6 +235,17 @@ param objectToTest object = {
 output bar bool = contains(objectToTest, 'four') && objectToTest.four == 4
 ```
 
+### Object-related operators
+
+* Use [Comparison operators](./operators-comparison.md) to compare objects.
+* Use [Index accessor](./operators-access.md#index-accessor) to get a property from an object.
+* Use [Safe-dereference operator](./operator-safe-dereference.md) to access object members.
+* Use [Spread](./operator-spread.md) to merge objects.
+
+### Object-related functions
+
+See [Object functions](./bicep-functions-object.md).
+
 ## Strings
 
 In Bicep, strings are marked with single quotation marks, and you must declare them on a single line. All Unicode characters with code points between `0` and `10FFFF` are allowed.
@@ -317,6 +346,13 @@ var myVar6 = '''interpolation
 is ${blocked}'''
 ```
 
+### String-related operators
+
+* See [Comparison operators](./operators-comparison.md).
+
+### String-related functions
+
+
 ## Union types
 
 In Bicep, a union type allows the creation of a combined type that consists of a set of subtypes. An assignment is valid if any of the individual subtype assignments are permitted. The `|` character separates individual subtypes that use an `or` condition. For example, the syntax `a | b` means that a valid assignment could be either `a` or `b`. Union types are translated into the [allowed-value](../templates/definitions.md#allowed-values) constraint in Bicep, so only literals are permitted as members. Unions can include any number of literal-typed expressions.

articles/azure-resource-manager/bicep/operator-spread.md

@@ -3,7 +3,7 @@ title: Bicep spread operator
 description: Describes Bicep spread operator.
 ms.topic: conceptual
 ms.custom: devx-track-bicep
-ms.date: 08/07/2024
+ms.date: 11/20/2024
 ---
 
 # Bicep spread operator
@@ -74,6 +74,24 @@ In this usage, comma isn't used between the two lines.  Output from the example:
 |------|------|-------|
 | `objCombined` | object | { color: 'white', shape: 'circle' } |
 
+The following example shows how to conditionally add an array element:
+
+```bicep
+@allowed(['white', 'black'])
+param color string = 'black'
+
+var colorWhite = { color: 'white' }
+var colorBlack = { color: 'black' }
+
+output objB object = ((color == 'white')? { shape: 'circle', ...colorWhite} : { shape: 'circle', ...colorBlack})
+```
+
+Output from the example:
+
+| Name | Type | Value |
+|------|------|-------|
+| `objB` | object | { shape: 'circle', color: 'black' } |
+
 The spread operation can be used to avoid setting an optional property. In the following example, _accessTier_ is set only if the parameter _tier_ isn't an empty string.
 
 ```bicep