Merge pull request #295056 from mumian/0220-bcp-238

Add BCP 238

Author: v-dirichards

articles/azure-resource-manager/bicep/bicep-core-diagnostics.md

@@ -237,7 +237,7 @@ If you need more information about a particular diagnostic code, select the **Fe
 | <a id='BCP235' />BCP235 | Error | Specified JSONPath doesn't exist in the given file or is invalid. |
 | <a id='BCP236' />BCP236 | Error | Expected a new line or comma character at this location. |
 | <a id='BCP237' />BCP237 | Error | Expected a comma character at this location. |
-| <a id='BCP238' />BCP238 | Error | Unexpected new line character after a comma. |
+| <a id='BCP238' />[BCP238](./diagnostics/bcp238.md) | Error | Unexpected new line character after a comma. |
 | <a id='BCP239' />BCP239 | Error | Identifier "{name}" is a reserved Bicep symbol name and can't be used in this context. |
 | <a id='BCP240' />BCP240 | Error | The "parent" property only permits direct references to resources. Expressions aren't supported. |
 | <a id='BCP241' />BCP241 | Warning | The \<function-name> function is deprecated and will be removed in a future release of Bicep. Add a comment to https://github.com/Azure/bicep/issues/2017 if you believe this will impact your workflow. |

articles/azure-resource-manager/bicep/diagnostics/bcp238.md

@@ -0,0 +1,47 @@
+---
+title: BCP238
+description: Unexpected new line character after a comma.
+ms.topic: reference
+ms.custom: devx-track-bicep
+ms.date: 02/12/2025
+---
+
+# Bicep diagnostic code - BCP238
+
+In Bicep, arrays or objects can be declared on a single line or across multiple lines. In single-line declarations, values are separated by commas (,), while in multi-line declarations, commas aren't used. You can combine single-line and multi-line styles, but each element must be separated by no more than one comma or one set of new lines. This diagnostic occurs when this rule isn't followed. For more information, see [Arrays](../data-types.md#arrays) or [Objects](../data-types.md#objects).
+
+## Description
+
+Unexpected new line character after a comma.
+
+## Level
+
+Error
+
+## Solution
+
+Remove Use a name of a value.
+
+## Examples
+
+The following example raises the diagnostic because a comma and a new line are used in between _'def'_ and _'ghi'_:
+
+```bicep
+var mixedArray = ['abc', 'def',
+    'ghi']
+```
+
+You can fix the diagnostic by removing either the comma or the new line:
+
+```bicep
+var mixedArray = ['abc', 'def'
+    'ghi']
+```
+
+```bicep
+var mixedArray = ['abc', 'def', 'ghi']
+```
+
+## Next steps
+
+For more information about Bicep diagnostics, see [Bicep core diagnostics](../bicep-core-diagnostics.md).

articles/azure-resource-manager/bicep/toc.yml

@@ -697,6 +697,8 @@
       href: diagnostics/bcp170.md
     - name: BCP192
       href: diagnostics/bcp192.md
+    - name: BCP238
+      href: diagnostics/bcp238.md
     - name: BCP266
       href: diagnostics/bcp266.md
     - name: BCP288