diff options
| author | Alex Gaynor <alex.gaynor@gmail.com> | 2013-12-21 19:26:19 -0800 |
|---|---|---|
| committer | Alex Gaynor <alex.gaynor@gmail.com> | 2013-12-21 19:26:19 -0800 |
| commit | 6955ea32cdfbc8719c5f4ae9c55c989787553a97 (patch) | |
| tree | 58d6ceb4d12495038272ff7fc4e6dbafc345525b | |
| parent | 8eda240d0e055e16c26021de2624eb7fab1ccb47 (diff) | |
| download | cryptography-6955ea32cdfbc8719c5f4ae9c55c989787553a97.tar.gz cryptography-6955ea32cdfbc8719c5f4ae9c55c989787553a97.tar.bz2 cryptography-6955ea32cdfbc8719c5f4ae9c55c989787553a97.zip | |
Recommend that recipes include a version
| -rw-r--r-- | docs/contributing.rst | 4 |
1 files changed, 4 insertions, 0 deletions
diff --git a/docs/contributing.rst b/docs/contributing.rst index cb9c7283..cec067ca 100644 --- a/docs/contributing.rst +++ b/docs/contributing.rst @@ -77,6 +77,10 @@ whether the signature was valid. if not is_valid: raise InvalidSignature +Every recipe should include a version or algorithmic marker of some sort in its +output in order to allow transparent upgrading of the algorithms in use, as +the algorithms or parameters needed to achieve a given security margin evolve. + APIs at the :doc:`/hazmat/primitives/index` layer should always take an explicit backend, APIs at the recipes layer should automatically use the :func:`~cryptography.hazmat.backends.default_backend`, but optionally allow |