Merge pull request #10628 from MicrosoftDocs/main638755850610518842sync_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/extensibility/visualstudio.extensibility/project/project-concepts.md

@@ -52,7 +52,9 @@ This overview covers top scenarios for working with the project query API:
 - [Action Query to Load/Unload a Project](#action-query-to-loadunload-a-project)
 - [Action Query to Build Solutions/Projects](#action-query-to-build-solutionsprojects)
 - [Action Query to Save a Solution/Project](#action-query-to-save-solutionsprojects)
+- [Query to Subscribe to Query Changes](#query-to-subscribe-to-query-changes)
 - [Query to Track Query Changes](#query-to-track-query-changes)
+- [Events to monitor solution open and close](#events-to-monitor-solution-open-and-close)
 - [Action Query to Skip](#action-query-to-skip)
 
 ## Access the project query space
@@ -696,6 +698,26 @@ private class TrackerObserver : IObserver<IQueryTrackUpdates<IFileSnapshot>>
 }
 ```
 
+## Events to monitor solution open and close
+
+The `QueryableSpaceChanged` event can be subscribed to for monitoring when solutions open and close using a workspace created with a service broker. `ProjectQueryableSpaceChangedEventArgs` contains two fields, `SolutionPath` and `QueryableSpaceVersion`. The string `SolutionPath` is the path the solution that opened or null if a solution closed. The int `QueryableSpaceVersion` increments as solutions are opened or closed.
+
+```csharp
+private void SubscribeToEvent() 
+{
+    IServiceBroker serviceBroker = context.Extensibility.ServiceBroker;
+    ProjectQueryableSpace workspace = new(serviceBroker: serviceBroker, joinableTaskContext: null);
+    workspace.QueryableSpaceChanged += EventCalledAsync;
+}
+
+private Task EventCalledAsync(ProjectQueryableSpaceChangedEventArgs e)
+{
+    string? solutionPath = e.SolutionPath;
+    int version = e.QueryableSpaceVersion;
+    ...
+}
+```
+
 ## Action query to skip
 
 `Skip` can be used to skip N results from a query.

docs/extensibility/visualstudio.extensibility/project/project.md

@@ -99,9 +99,17 @@ For more information, see [CPU insights](../profiling/cpu-insights.md).
 ## Analyze CPU utilization
 
 ::: moniker range=">=vs-2022"
-To analyze the CPU Usage report, click **Open details**, or click one of the top functions to open the **Functions** view.
+For in-depth analysis of the CPU Usage report, first open one of the detailed report views:
 
-The report provides different views of the diagnostic data:
+1. Click **Open details** in the summary page of the report, or select one of the top functions to open the **Functions** view.
+
+   ![Screenshot that shows the Open details link.](../profiling/media/vs-2022/cpu-use-open-details.png)
+
+1. From the **Current View** list, you can select one of the detailed report views.
+
+   ![Screenshot that shows the list of detailed reports.](../profiling/media/vs-2022/cpu-use-select-detailed-view.png)
+
+The following table provides a description of the detailed views.
 
 |View|Description|
 |-|-|

docs/profiling/cpu-usage.md

@@ -67,9 +67,17 @@ In addition, if you're using Copilot, use the **Ask Copilot** button to open the
 
 ## Analyze instrumentation detailed reports
 
-To analyze the Instrumentation report, click **Open details**, or click one of the top functions to open the **Functions** view.
+For in-depth analysis of the Instrumentation report, first open one of the detailed report views:
 
-The report provides different views of the diagnostic data:
+1. Click **Open details** in the summary page of the report, or select one of the top functions to open the **Functions** view.
+
+   ![Screenshot that shows the Open details link.](../profiling/media/vs-2022/cpu-use-open-details.png)
+
+1. From the **Current View** list, you can select one of the detailed report views.
+
+   ![Screenshot that shows the list of detailed reports.](../profiling/media/vs-2022/cpu-use-select-detailed-view.png)
+
+The following table provides a description of the detailed views.
 
 |View|Description|
 |-|-|