From 6777ad1c69bbda8c355f9cc75853a9f15011bb8d Mon Sep 17 00:00:00 2001
From: Christoph Wurst <christoph@winzerhof-wurst.at>
Date: Wed, 19 Apr 2023 16:35:01 +0200
Subject: [PATCH] feat(devmanual): Start 27 upgrade docs

Signed-off-by: Christoph Wurst <christoph@winzerhof-wurst.at>
---
 .../app_upgrade_guide/index.rst               |  1 +
 .../app_upgrade_guide/upgrade_to_27.rst       | 51 +++++++++++++++++++
 2 files changed, 52 insertions(+)
 create mode 100644 developer_manual/app_publishing_maintenance/app_upgrade_guide/upgrade_to_27.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 ef131d8ed..65660dca8 100644
--- a/developer_manual/app_publishing_maintenance/app_upgrade_guide/index.rst
+++ b/developer_manual/app_publishing_maintenance/app_upgrade_guide/index.rst
@@ -9,6 +9,7 @@ These sub pages will cover the most important changes in Nextcloud, as well as s
 .. toctree::
    :maxdepth: 1
 
+   upgrade_to_27.rst
    upgrade_to_26.rst
    upgrade_to_25.rst
    upgrade_to_24.rst
diff --git a/developer_manual/app_publishing_maintenance/app_upgrade_guide/upgrade_to_27.rst b/developer_manual/app_publishing_maintenance/app_upgrade_guide/upgrade_to_27.rst
new file mode 100644
index 000000000..51323ce34
--- /dev/null
+++ b/developer_manual/app_publishing_maintenance/app_upgrade_guide/upgrade_to_27.rst
@@ -0,0 +1,51 @@
+=======================
+Upgrade to Nextcloud 27
+=======================
+
+.. note:: Critical changes were collected `on GitHub <https://github.com/nextcloud/server/issues/37039>`_.
+    See the original ticket for links to the pull requests and tickets.
+
+General
+-------
+
+info.xml
+^^^^^^^^
+
+Make sure your ``appinfo/info.xml`` allows for Nextcloud 27.
+
+.. code-block:: xml
+
+    <dependencies>
+        <nextcloud min-version="23" max-version="27" />
+    </dependencies>
+
+Front-end changes
+-----------------
+
+Removed APIs
+^^^^^^^^^^^^
+
+* tbd
+
+Back-end changes
+----------------
+
+Added APIs
+^^^^^^^^^^
+
+* tbd
+
+Changed APIs
+^^^^^^^^^^^^
+
+* tbd
+
+Deprecated APIs
+^^^^^^^^^^^^^^^
+
+* tbd
+
+Removed APIs
+^^^^^^^^^^^^
+
+* tbd