From c92e79a9cbe350be8f9fc6f153c692a83e2d1d2e Mon Sep 17 00:00:00 2001
From: Jos Poortvliet <jospoortvliet@gmail.com>
Date: Wed, 29 Jul 2020 20:21:56 +0200
Subject: [PATCH] Update externalapi.rst

---
 developer_manual/core/externalapi.rst | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/developer_manual/core/externalapi.rst b/developer_manual/core/externalapi.rst
index e232c3555..aae504935 100644
--- a/developer_manual/core/externalapi.rst
+++ b/developer_manual/core/externalapi.rst
@@ -117,3 +117,13 @@ The statuscode can be any of the following numbers:
 * **997** - not authorized
 * **998** - not found
 * **999** - unknown error
+
+Changing API and backwards compatibility
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+We aim to keep our API as stable as possible to avoid breaking third-party apps.
+Before an API is allowed to be removed, it should be marked as deprecated for at
+least 2 years (6 Nextcloud releases) before it gets removed.
+
+Changing the API `should be discussed in a github issue in our server repo
+<https://github.com/nextcloud/server/issues>`_. A pull request is most welcome.