Document --bl parameter for dotnet build

Fixes #50115

Author: hasbiyallah01

docs/core/tools/dotnet-build.md

@@ -23,7 +23,8 @@ dotnet build [<PROJECT>|<SOLUTION>|<FILE>] [-a|--arch <ARCHITECTURE>]
     [-p|--property:<PROPERTYNAME>=<VALUE>] [-r|--runtime <RUNTIME_IDENTIFIER>]
     [--sc|--self-contained] [--source <SOURCE>]
     [--tl:[auto|on|off]] [ --ucr|--use-current-runtime]
-    [-v|--verbosity <LEVEL>] [--version-suffix <VERSION_SUFFIX>]
+    [-v|--verbosity <LEVEL>] [--bl[:<FILE>]] [--version-suffix <VERSION_SUFFIX>]
+
 
 dotnet build -h|--help
 ```
@@ -148,6 +149,19 @@ Running `dotnet build` is equivalent to running `dotnet msbuild -restore`; howev
 
 - [!INCLUDE [verbosity](../../../includes/cli-verbosity.md)]
 
+- **`--bl[:<FILE>]`**
+
+  Enables the binary logger and optionally specifies the output file name.  
+  If no file name is provided, the default is `msbuild.binlog` in the current directory.
+
+  The binary log contains detailed build information and can be opened with the
+  [MSBuild Structured Log Viewer](https://msbuildlog.com).
+
+  ```dotnetcli
+  dotnet build --bl
+  dotnet build --bl:build-log.binlog
+  ```
+
 - **`--version-suffix <VERSION_SUFFIX>`**
 
   Sets the value of the `$(VersionSuffix)` property to use when building the project. This only works if the `$(Version)` property isn't set. Then, `$(Version)` is set to the `$(VersionPrefix)` combined with the `$(VersionSuffix)`, separated by a dash.
@@ -193,3 +207,9 @@ Running `dotnet build` is equivalent to running `dotnet msbuild -restore`; howev
   ```dotnetcli
   dotnet build -p:Version=1.2.3.4
   ```
+
+- Build a project and its dependencies:
+
+  ```dotnetcli
+  dotnet build
+  ```