multi-doc highlighting

release-notes/images/1_85/multi-document-highlight.mp4

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:7dd782c52124f581ecbf0a0b95b20b2cabc563d014267e8b66df377fde1aab0c
+size 2008228

release-notes/v1_85.md

@@ -129,6 +129,12 @@ explicit: Triggers Code Actions when explicitly saved. Same as true.
 always: Triggers Code Actions when explicitly saved and on Auto Saves from window or focus changes.
 never: Never triggers Code Actions on save. Same as false.
 
+### Multi Document Highlighting
+
+Multi Document Highlighting has received additional support thanks to new proposed api for Multi Document Highlight Providers. There is now out of the box support for semantic occurrence highlighting for the Typescript language, which can be enabled by changing the **Editor: Occurrences Highlight** enum from `singleFile` to `multiFile`. You can also choose to place the following in your `settings.json`: `"editor.occurrencesHighlight": "multiFile"`. For languages besides typescript, multi document occurrences will be highlighted based off of textual occurrences rather than semantic occurrences until further providers are implemented.
+
+<video src="images/1_85/multi-document-highlight.mp4" autoplay loop controls muted title="Semantic Multi Document Highlighting across Typescript files"></video>
+
 ## Source Control
 
 ### Incoming/Outgoing changes
@@ -396,6 +402,10 @@ This iteration we revived work on test coverage, with initial UI integration and
 
 As mentioned in our recent blog post, [Pursuit of "wicked smartness" in VS Code](https://code.visualstudio.com/blogs/2023/11/13/vscode-copilot-smarter#_extensibility), we have been developing a model for extensions to contribute chat agents to the Copilot Chat view. The chat agent API is proposed, but you can experiment with adding your own chat agent now. Subscribe to [issue #199908](https://github.com/microsoft/vscode/issues/199908) for updates.
 
+### Multi Document Highlighting
+
+As introduced in the previous release, there is now support for multi document highlighting within VS Code. This iteration, we have introduced proposed api that allows for the registration of multi document highlight providers. This is directly driving the ability to provide semantic occurrence highlighting within various languages as this feature is more widely adopted. There is now a new `MultiDocumentHighlight` structure that allows the provider to return a Map of `URI` to `DocumentHighlight`. Feedback and further updates can be tracked via [issue #196354](https://github.com/microsoft/vscode/issues/196354).
+
 ## Engineering
 
 ### macOS 10.13 and 10.14 support has ended