edit

Author: mumian

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

@@ -140,17 +140,17 @@ This command converts a _params.bicepparam_ parameters file into a _params.json_
 
 ## console
 
-The `console` command is available in Bicep CLI v0.42.1 or later. It provides an interactive Read-Eval-Print Loop (REPL) environment for Bicep expressions. It allows you to experiment with Bicep functions and expressions in an interactive console session. It supports the following features:
+The `console` command is available in Bicep CLI v0.42.1 or later. It provides an interactive Read-Eval-Print Loop (REPL) environment for Bicep expressions. It allows you to experiment with Bicep functions and expressions in an interactive console session, especially useful when authoring or testing Bicep logic such as expressions, functions, and user-defined functions.. It supports the following features:
 
 * **Interactive Expression Evaluation**: Enter Bicep expressions and see their evaluated results immediately
-* **Variable Declarations**: Define variables using var name = expression syntax and reuse them in subsequent expressions
+* **Variable Declarations**: Define variables using `var name = expression syntax and reuse them in subsequent expressions
 * **Multi-line Input**: Support for complex multi-line expressions with automatic structural completion detection
 * **Syntax Highlighting**: Real-time syntax highlighting for input and output
 
 The `console` command has these limitations:
 
-* No support for expressions requiring Azure context, e.g. resourceGroup()
-* No support for for-loop expressions, e.g. [for i in range(0, x): i]
+* No support for expressions requiring Azure context, e.g. `resourceGroup()`
+* No support for for-loop expressions, e.g. `[for i in range(0, x): i]`
 * No persistent state between console sessions
 * No completions support
 
@@ -172,19 +172,6 @@ To exit the console, press `ESC` or use the `exit` command.
 
 ### Examples
 
-#### Simple Expressions
-```bicep
-> 1 + 2
-3
-
-> 'Hello, ' + 'World!'
-'Hello, World!'
-
-> length(['a', 'b', 'c'])
-3
-
-```
-
 #### Simple Expressions
 
 ```bicep
@@ -266,9 +253,9 @@ true
 
 #### Loading content from files
 
-Bicep console also supports the [`load*()` functions](./bicep-functions-files.md#file-functions-for-bicep). Note: The directory from which the `bicep console` command is run is used as the _current directory_ when evaluating the `load*()` functions
+Bicep console also supports the [`load*()` functions](./bicep-functions-files.md#file-functions-for-bicep). The directory from which the `bicep console` command is run is used as the _current directory_ when evaluating the `load*()` functions
 
-The following example shows how to use `loadDirectoryFileInfo()` to load information about all Bicep files in a directory:
+The following example shows how to use [`loadDirectoryFileInfo()`](./bicep-functions-files.md#loaddirectoryfileinfo) to load information about all Bicep files in a directory:
 
 ```bicep
 > loadDirectoryFileInfo('./modules/', '*.bicep')
@@ -283,7 +270,11 @@ The following example shows how to use `loadDirectoryFileInfo()` to load informa
 
 #### Piping and standard input/output redirection
 
-The console command supports evaluating expressions provided through piping or redirected standard input, i.e.:
+The console command supports evaluating expressions provided through piping or redirected standard input, enabling scenarios like:
+
+* Passing expression text via echo
+* Composing scripts that feed expressions into the console
+* Rapid testing of generated or transformed Bicep snippets
 
 **Powershell**:
 
@@ -301,7 +292,7 @@ echo "parseCidr('10.144.0.0/20')" | bicep console
 bicep console < test.txt
 ```
 
-Multi-line input is also supported, i.e:
+Multi-line input is also supported:
 
 ```powershell
 "{