From 35e297bc3ca4f29d4c816fbe81b88a8013cd9cc5 Mon Sep 17 00:00:00 2001
From: Gabriel Engel <gengel@gitlab.com>
Date: Wed, 14 Feb 2024 09:04:26 +0000
Subject: [PATCH] Deprecation - Windows 2019 for SaaS runners on Windows

---
 .../17-0-deprecation-windows-server-2019.yml     | 12 ++++++++++++
 doc/update/deprecations.md                       | 16 ++++++++++++++++
 2 files changed, 28 insertions(+)
 create mode 100644 data/deprecations/17-0-deprecation-windows-server-2019.yml

diff --git a/data/deprecations/17-0-deprecation-windows-server-2019.yml b/data/deprecations/17-0-deprecation-windows-server-2019.yml
new file mode 100644
index 0000000000000..6470f9afcdcfb
--- /dev/null
+++ b/data/deprecations/17-0-deprecation-windows-server-2019.yml
@@ -0,0 +1,12 @@
+- title: "Deprecating Windows Server 2019 in favor of 2022"
+  removal_milestone: "17.0"
+  announcement_milestone: "16.9"
+  breaking_change: true
+  reporter: gabrielengel_gl
+  stage: Verify
+  issue_url: https://gitlab.com/gitlab-org/gitlab/-/issues/438554
+  manual_task: true
+  body: |  # (required) Don't change this line.
+    We have recently announced the release of Windows Server 2022 for our SaaS runners on Windows (Beta). With it, we are deprecating Windows 2019 in GitLab 17.0.
+
+    For more information about how to migrate to using Windows 2022, see [Windows 2022 support for GitLab SaaS runners now available](https://about.gitlab.com/blog/2024/01/22/windows-2022-support-for-gitlab-saas-runners/).
diff --git a/doc/update/deprecations.md b/doc/update/deprecations.md
index b7627c2999e3e..08ff463b0b1d2 100644
--- a/doc/update/deprecations.md
+++ b/doc/update/deprecations.md
@@ -844,6 +844,22 @@ The parameters, `sign_in_text` and `help_text`, are deprecated in the [Settings
 
 <div class="deprecation breaking-change" data-milestone="17.0">
 
+### Deprecating Windows Server 2019 in favor of 2022
+
+<div class="deprecation-notes">
+- Announced in GitLab <span class="milestone">16.9</span>
+- Removal in GitLab <span class="milestone">17.0</span> ([breaking change](https://docs.gitlab.com/ee/update/terminology.html#breaking-change))
+- To discuss this change or learn more, see the [deprecation issue](https://gitlab.com/gitlab-org/gitlab/-/issues/438554).
+</div>
+
+We have recently announced the release of Windows Server 2022 for our SaaS runners on Windows (Beta). With it, we are deprecating Windows 2019 in GitLab 17.0.
+
+For more information about how to migrate to using Windows 2022, see [Windows 2022 support for GitLab SaaS runners now available](https://about.gitlab.com/blog/2024/01/22/windows-2022-support-for-gitlab-saas-runners/).
+
+</div>
+
+<div class="deprecation breaking-change" data-milestone="17.0">
+
 ### DingTalk OmniAuth provider
 
 <div class="deprecation-notes">
-- 
GitLab