diff options
Diffstat (limited to 'docs/backward-compatibility.rst')
-rw-r--r-- | docs/backward-compatibility.rst | 11 |
1 files changed, 11 insertions, 0 deletions
diff --git a/docs/backward-compatibility.rst b/docs/backward-compatibility.rst new file mode 100644 index 0000000..1ff5ed6 --- /dev/null +++ b/docs/backward-compatibility.rst @@ -0,0 +1,11 @@ +Backward Compatibility +====================== + +``service_identity`` 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`. |