Merge pull request #328 from microsoft/dev/maiak/updateAnnouncements

Fix ordering of announcements.

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

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.
+* [VisualStudio.Extensibility phase 2](https://devblogs.microsoft.com/visualstudio/visualstudio-extensibility/) is released publicly adding more extensibility feature areas.