the twisted backwards compatability policy moved (#688)

in a backwards compatible way
This commit is contained in:
Thomas Grainger 2020-09-10 12:22:20 +01:00 committed by GitHub
parent 28d75dbf89
commit fe8fe011df
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 1 additions and 1 deletions

View File

@ -3,7 +3,7 @@ Backward Compatibility
.. currentmodule:: attr .. currentmodule:: attr
``attrs`` has a very strong backward compatibility policy that is inspired by the policy of the `Twisted framework <https://twistedmatrix.com/trac/wiki/CompatibilityPolicy>`_. ``attrs`` has a very strong backward compatibility policy that is inspired by the policy of the `Twisted framework <https://twistedmatrix.com/documents/current/core/development/policy/compatibility-policy.html>`_.
Put simply, you shouldn't ever be afraid to upgrade ``attrs`` if you're only using its public APIs. Put simply, you shouldn't ever be afraid to upgrade ``attrs`` if you're only using its public APIs.
If there will ever be a need to break compatibility, it will be announced in the `changelog` and raise a ``DeprecationWarning`` for a year (if possible) before it's finally really broken. If there will ever be a need to break compatibility, it will be announced in the `changelog` and raise a ``DeprecationWarning`` for a year (if possible) before it's finally really broken.