From de673e3616d39ad3896ab13d8a109aa2aaa9d987 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Lo=C3=AFc=20Dachary?= <ldachary@easter-eggs.com>
Date: Fri, 18 Jun 2021 13:06:00 +0200
Subject: [PATCH] add URLs of the source files for all settings (#54983)

The settings names and default values are scattered in the sources and
it is non trivial to figure out where they are. Add a list of all
source files that contain settings variables as a reference.

License MIT
---
 configuration.rst | 23 +++++++++++++++++++++--
 1 file changed, 21 insertions(+), 2 deletions(-)

diff --git a/configuration.rst b/configuration.rst
index d6321b6..d3ca2b0 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -4,8 +4,27 @@
 Configuration
 =============
 
-Configuration with settings
-===========================
+Configuration from files
+========================
+
+Authentic 2 can be configured by adding or overriding:
+
+* `Django settings <https://docs.djangoproject.com/en/2.2/topics/settings/>`__
+* `Authentic 2 Django settings <https://git.entrouvert.org/authentic.git/tree/src/authentic2/settings.py>`__
+* `Authentic 2 A2_* settings <https://git.entrouvert.org/authentic.git/tree/src/authentic2/app_settings.py>`__
+* `Authentic 2 SAML_* settings <https://git.entrouvert.org/authentic.git/tree/src/authentic2/saml/app_settings.py>`__
+* `Authentic 2 A2_FC_* settings <https://git.entrouvert.org/authentic.git/tree/src/authentic2_auth_fc/app_settings.py>`__
+* `Authentic 2 A2_AUTH_OIDC_* settings <https://git.entrouvert.org/authentic.git/tree/src/authentic2_auth_oidc/app_settings.py>`__
+* `Authentic 2 A2_AUTH_SAML_* settings <https://git.entrouvert.org/authentic.git/tree/src/authentic2_auth_saml/app_settings.py>`__
+* `Authentic 2 A2_IDP_CAS_* settings <https://git.entrouvert.org/authentic.git/tree/src/authentic2_idp_cas/app_settings.py>`__
+* `Authentic 2 A2_IDP_OIDC_* settings <https://git.entrouvert.org/authentic.git/tree/src/authentic2_idp_oidc/app_settings.py>`__
+* `Authentic 2 LDAP_AUTH_SETTINGS <https://git.entrouvert.org/authentic.git/tree/src/authentic2/backends/ldap_backend.py#n531>`__
+
+The following files will be read, in the following order, and their
+value will override the defaults found in the sources above:
+
+* `/etc/authentic2/config.py`
+* `/etc/authentic2/settings.d/*.py` (sorted in alphabetical order)
 
 Configuration with the administration interface
 ===============================================