From c809e6f49dc70ebb492ceac6cac6e1f47ccbbfaf Mon Sep 17 00:00:00 2001
From: Ferdinand Thiessen <opensource@fthiessen.de>
Date: Mon, 8 Sep 2025 17:56:32 +0200
Subject: [PATCH] feat(developer): document removal of global `md5`

Signed-off-by: Ferdinand Thiessen <opensource@fthiessen.de>
---
 .../app_upgrade_guide/index.rst               |  1 +
 .../app_upgrade_guide/upgrade_to_33.rst       | 55 +++++++++++++++++++
 2 files changed, 56 insertions(+)
 create mode 100644 developer_manual/app_publishing_maintenance/app_upgrade_guide/upgrade_to_33.rst

diff --git a/developer_manual/app_publishing_maintenance/app_upgrade_guide/index.rst b/developer_manual/app_publishing_maintenance/app_upgrade_guide/index.rst
index 4aae36348e8..b5109104dce 100644
--- a/developer_manual/app_publishing_maintenance/app_upgrade_guide/index.rst
+++ b/developer_manual/app_publishing_maintenance/app_upgrade_guide/index.rst
@@ -11,6 +11,7 @@ These sub pages will cover the most important changes in Nextcloud, as well as s
 .. toctree::
    :maxdepth: 1
 
+   upgrade_to_33.rst
    upgrade_to_32.rst
    upgrade_to_31.rst
    upgrade_to_30.rst
diff --git a/developer_manual/app_publishing_maintenance/app_upgrade_guide/upgrade_to_33.rst b/developer_manual/app_publishing_maintenance/app_upgrade_guide/upgrade_to_33.rst
new file mode 100644
index 00000000000..e14be3c60f6
--- /dev/null
+++ b/developer_manual/app_publishing_maintenance/app_upgrade_guide/upgrade_to_33.rst
@@ -0,0 +1,55 @@
+=======================
+Upgrade to Nextcloud 33
+=======================
+
+Front-end changes
+-----------------
+
+Added APIs
+^^^^^^^^^^
+
+- TBD
+
+Changed APIs
+^^^^^^^^^^^^
+
+- TBD
+
+Deprecated APIs
+^^^^^^^^^^^^^^^
+
+- TBD
+
+Removed APIs
+^^^^^^^^^^^^
+
+- The global ``md5`` implementation is removed. It was deprecated since Nextcloud 20 and not used by Nextcloud anymore.
+  If you still need a ``md5`` implementation you can just use some external package like `crypto-browserify <https://www.npmjs.com/package/crypto-browserify>`_.
+
+Back-end changes
+----------------
+
+Added Events
+^^^^^^^^^^^^
+
+- TBD
+
+Added APIs
+^^^^^^^^^^
+
+- TBD
+
+Changed APIs
+^^^^^^^^^^^^
+
+- TBD
+
+Deprecated APIs
+^^^^^^^^^^^^^^^
+
+- TBD
+
+Removed APIs
+^^^^^^^^^^^^
+
+- TBD