diff --git a/README.md b/README.md index cfe2e0fb..d4c65274 100644 --- a/README.md +++ b/README.md @@ -34,6 +34,8 @@ Documentation is currently available for the following: | [Overviews](#overviews) | Learn more by reading overviews of each major area of functionality. | | [Samples](#samples-and-tutorials) | Explore sample code demonstrating major features. | | [API reference](#api-docs) | Browse the VisualStudio.Extensibility API documentation. | +| [Experimental APIs and Breaking Changes](#experimental-apis-and-breaking-changes) | Learn about our approach to stable-vs-experimental APIs and about breaking changes from the previous version. | +| [Known Issues](#known-issues) | View known issues with the VisualStudio.Extensibility SDK. | | [Advanced topics](#advanced-topics) | Learn implementation details of the VisualStudio.Extensibility SDK. | ## Install VisualStudio.Extensibility diff --git a/docs/announcements.md b/docs/announcements.md index 58ea6645..9e4e1729 100644 --- a/docs/announcements.md +++ b/docs/announcements.md @@ -7,6 +7,22 @@ date: 2022-8-10 # Announcements Use this page to stay up-to-date on all upcoming extensibility announcements and critical SDK/API updates. +## February 20, 2024 +We've released updated packages and templates starting with the Visual Studio 2022 17.9 official release. This version adds the following new features: +* Create VSIX packages that can be shared with other users and published to the Visual Studio Marketplace +* Install VisualStudio.Extensibility-based extensions without restarting Visual Studio +* Configure your extensions in-code with updated configuration properties +* Create dockable/non-modal debugger visualizers +* Leverage your LSP servers in your extensions +* Query the project system with an enhanced query API. + +To learn more, please see our [announcement on the Visual Studio blog](https://devblogs.microsoft.com/visualstudio/visualstudio-extensibility-17-9/). + +In addition, we've also formalized our stability model for our APIs, and added the following new pages: +* [Known Issues](./known_issues.md) - lists known issues with the VisualStudio.Extensibility SDK. +* [Experimental APIs](./experimental_apis.md) - lists APIs that are considered experimental/non-stable and describes how to use them. +* [Breaking Changes](./breaking_changes.md) - lists APIs that have had breaking changes since the previous release. + ## May 19, 2023 * Documentation moved to the Learn platform: [https://learn.microsoft.com/en-us/visualstudio/extensibility/visualstudio.extensibility/?view=vs-2022](VisualStudio.Extensibility documentation) @@ -23,20 +39,4 @@ Use this page to stay up-to-date on all upcoming extensibility announcements and * VSExtensibility site/repository goes public! ## August 10, 2022 -* [VisualStudio.Extensibility phase 2](https://devblogs.microsoft.com/visualstudio/visualstudio-extensibility/) is released publicly adding more extensibility feature areas. - -## February 20, 2024 -We've released updated packages and templates starting with the Visual Studio 2022 17.9 official release. This version adds the following new features: -* Create VSIX packages that can be shared with other users and published to the Visual Studio Marketplace -* Install VisualStudio.Extensibility-based extensions without restarting Visual Studio -* Configure your extensions in-code with updated configuration properties -* Create dockable/non-modal debugger visualizers -* Leverage your LSP servers in your extensions -* Query the project system with an enhanced query API. - -To learn more, please see our [announcement on the Visual Studio blog](https://devblogs.microsoft.com/visualstudio/visualstudio-extensibility-17-9/). - -In addition, we've also formalized our stability model for our APIs, and added the following new pages: -* [Known Issues](./known_issues.md) - lists known issues with the VisualStudio.Extensibility SDK. -* [Experimental APIs](./experimental_apis.md) - lists APIs that are considered experimental/non-stable and describes how to use them. -* [Breaking Changes](./breaking_changes.md) - lists APIs that have had breaking changes since the previous release. \ No newline at end of file +* [VisualStudio.Extensibility phase 2](https://devblogs.microsoft.com/visualstudio/visualstudio-extensibility/) is released publicly adding more extensibility feature areas. \ No newline at end of file