From b5a7a8843289be64ede4e9be5d8e39cab0d5addc Mon Sep 17 00:00:00 2001
From: Alan Clucas <alan@clucas.org>
Date: Thu, 17 Oct 2024 08:21:44 +0100
Subject: [PATCH] docs: add deprecations to upgrading guide (#13757)

Signed-off-by: Alan Clucas <alan@clucas.org>
---
 docs/upgrading.md | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/docs/upgrading.md b/docs/upgrading.md
index 27a01747556d..9459a247e0ad 100644
--- a/docs/upgrading.md
+++ b/docs/upgrading.md
@@ -5,6 +5,15 @@ the [conventional commits](https://www.conventionalcommits.org/en/v1.0.0/#summar
 
 ## Upgrading to v3.6
 
+### Deprecations
+
+The following features are deprecated and will be removed in a future verison of Argo Workflows:
+
+* The Python SDK is deprecated, we recommend migrating to [Hera](https://github.com/argoproj-labs/hera)
+* `schedule` in CronWorkflows, `podPriority`, `mutex` and `semaphore` in Workflows and WorkflowTemplates.
+
+For more information on how to migrate these see [deprecations](deprecations.md)
+
 ### Fixed Server `--basehref` inconsistency
 
 For consistency, the Server now uses `--base-href` and `ARGO_BASE_HREF`.