summaryrefslogtreecommitdiff
path: root/doc/backward-compatibility.rst
diff options
context:
space:
mode:
authorHynek Schlawack <hs@ox.cx>2015-10-25 16:15:12 +0100
committerHynek Schlawack <hs@ox.cx>2015-10-25 16:23:04 +0100
commit682443fc1e1d572d52cea0485f96728cb119edbc (patch)
tree45501acb731576c5b2f37dd57a3273d15e85b495 /doc/backward-compatibility.rst
parentd9fcd7a679a13862d954564ce2559bedaaee27f5 (diff)
downloadpyopenssl-682443fc1e1d572d52cea0485f96728cb119edbc.tar.gz
Switch to a nicer changelog format
Diffstat (limited to 'doc/backward-compatibility.rst')
-rw-r--r--doc/backward-compatibility.rst11
1 files changed, 11 insertions, 0 deletions
diff --git a/doc/backward-compatibility.rst b/doc/backward-compatibility.rst
new file mode 100644
index 0000000..446339b
--- /dev/null
+++ b/doc/backward-compatibility.rst
@@ -0,0 +1,11 @@
+Backward Compatibility
+======================
+
+pyOpenSSL has a very strong backward compatibility policy.
+Generally speaking, you shouldn't ever be afraid of updating.
+
+If breaking changes are needed do be done, they are:
+
+#. …announced in the :doc:`changelog`.
+#. …the old behavior raises a :exc:`DeprecationWarning` for a year.
+#. …are done with another announcement in the :doc:`changelog`.