Merge pull request #5395 from MicrosoftDocs/main638848278079453454sync_temp

For protected branch, push strategy should use PR and merge to target branch method to work around git push error

Author: learn-build-service-prod[bot]

docs/build/reference/experimental-log.md

@@ -1,23 +1,28 @@
 ---
 title: "/experimental:log (Structured SARIF diagnostics)"
-description: "Use the /experimental:log compiler option to output experimental structured SARIF output for diagnostics."
-ms.date: 10/26/2023
+description: "The /experimental:log compiler option outputs experimental structured SARIF output for diagnostics."
+ms.date: 06/05/2025
 f1_keywords: ["/experimental:log"]
 helpviewer_keywords: ["/experimental:log", "SARIF", "structured diagnostics"]
 ---
 # `/experimental:log` (Structured SARIF diagnostics)
 
-Output [SARIF](https://sarifweb.azurewebsites.net/) diagnostics to the specified file. For more information, see [Structured SARIF Diagnostics](sarif-output.md).
+Output [SARIF](https://sarifweb.azurewebsites.net/) diagnostics to the specified file or directory. For more information, see [Structured SARIF Diagnostics](sarif-output.md).
 
 ## Syntax
 
-> **`/experimental:log`** *filename*
+> **`/experimental:log`** *filename*\
+> **`/experimental:log`** *directoryname\\*
 
 ## Arguments
 
 *filename*
 
-Where to output SARIF diagnostics. The `.sarif` suffix is added to *filename* to produce the final filename at which to store the resulting SARIF diagnostics. The space between `/experimental:log` and *filename* is optional. Paths that include spaces must be enclosed in double quotes. *filename* may name a relative or absolute path.
+The output file for SARIF diagnostics. The compiler automatically adds the `.sarif` extension to *filename*. The space between `/experimental:log` and *filename* is optional. Use double quotes around paths containing spaces. Both relative and absolute paths are supported.
+
+*directoryname\\*
+
+The output directory for SARIF diagnostics (for example, `/experimental:log sarif_output\`). Remember to add the trailing backslash (`\`) to indicate it's a directory. Each source file name forms the base name for each SARIF file saved in the directory. The compiler automatically adds the `.sarif` extension to each file name. The space between `/experimental:log` and *directoryname\\* is optional. Use double quotes around paths containing spaces. Both relative and absolute paths are supported.
 
 ## Remarks
 
@@ -28,19 +33,28 @@ Diagnostics are also output as text to the console as usual.
 ### To set this compiler option in the Visual Studio development environment
 
 1. Open the project's **Property Pages** dialog box. For details, see [Set C++ compiler and build properties in Visual Studio](../working-with-project-properties.md).
-
 1. Select the specific project **Configuration** and **Platform** for which you want to change the property. You can also choose **"All Configurations"** and **"All Platforms"**.
-
 1. Select the **Configuration Properties** > **C/C++** > **Command Line** property page.
-
 1. Modify the **Additional Options** property, and then choose **OK**.
 
-## Example
+## Examples
+
+The following command produces SARIF information for the compilation of `main.cpp` and saves it in the file `main.sarif`:
+
+```cmd
+cl /experimental:log main.cpp
+```
+
+The following command produces SARIF information for the compilation of `main.cpp` and saves it in the file `mySarifInfo.sarif`:
+
+```cmd
+cl /experimental:log mySarifInfo main.cpp
+```
 
-The following command produces SARIF information for the entire compilation in the `diags.sarif` file in the current directory:
+The following command produces SARIF information for the entire compilation and saves it in the `sarif_output` directory in the files `main.sarif` and `other.sarif`:
 
 ```cmd
-CL /experimental:logdiags main.cpp other.cpp
+cl /experimental:log sarif_output\ main.cpp other.cpp
 ```
 
 ## See also

docs/docfx.json

@@ -139,6 +139,7 @@
         "cross-platform/**.md": "tools",
         "data/**.md": "data-access",
         "dotnet/**.md": "cli-lang",
+        "embedded/**.md": "tools",
         "error-messages/**.md": "errors-warnings",
         "extensions/**.md": "cli-lang",
         "get-started/**.md": "cpp-lang",