From fc6434b63e70bddbb909036fbec2aad8feb4ab47 Mon Sep 17 00:00:00 2001 From: Michael Merickel Date: Sun, 29 Nov 2020 13:21:34 -0600 Subject: add a note and fix suggestions --- CHANGES.rst | 2 +- docs/glossary.rst | 2 +- docs/whatsnew-2.0.rst | 7 +++++++ 3 files changed, 9 insertions(+), 2 deletions(-) diff --git a/CHANGES.rst b/CHANGES.rst index ad8b983ab..f3333abc9 100644 --- a/CHANGES.rst +++ b/CHANGES.rst @@ -5,7 +5,7 @@ Features -------- - Add support for Python 3.9. - See https://github.com/Pylons/pyramid/issue/3622 + See https://github.com/Pylons/pyramid/issues/3622 - The ``aslist`` method now handles non-string objects when flattening. See https://github.com/Pylons/pyramid/pull/3594 diff --git a/docs/glossary.rst b/docs/glossary.rst index 17e3e4822..85d12b571 100644 --- a/docs/glossary.rst +++ b/docs/glossary.rst @@ -88,7 +88,7 @@ Glossary The project files contain metadata that allow the package(s) to be installed, distributed, and tested. distribution - Setuptools / python packaging terminology. A file representing an + Setuptools / Python packaging terminology. A file representing an installable library or application. Distributions are usually archives that have the suffix of ``.whl``, ``.tar.gz``, or ``.zip``. Distributions are the target of packaging-related commands such as ``pip install``. diff --git a/docs/whatsnew-2.0.rst b/docs/whatsnew-2.0.rst index d1f66707d..e97198b23 100644 --- a/docs/whatsnew-2.0.rst +++ b/docs/whatsnew-2.0.rst @@ -144,6 +144,13 @@ Deprecations Upgrading Authentication/Authorization -------------------------------------- +.. note:: + It's important to note that the principal and ACL features within :app:`Pyramid` are not going away, nor deprecated, nor removed. + Most ACL features are deprecated in their current locations and moved into the :mod:`pyramid.authorization` module. + The main change is that they are now more optional than before and modifications were made to make the top-level APIs less opinionated as well as simpler. + +:app:`Pyramid` provides a simple set of APIs for plugging in allowed/denied semantics in your application. + The authentication and authorization policies of Pyramid 1.x have been merged into a single :term:`security policy` in Pyramid 2.0. Authentication and authorization policies can still be used and will continue to function normally, however they have been deprecated and support may be removed in upcoming versions. -- cgit v1.2.3