(airflow) branch main updated: Clarify FAB and Auth documentation regarding external_db_managers (#69929)

[vi...@apache.org]

This is an automated email from the ASF dual-hosted git repository.

vincbeck pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/airflow.git


The following commit(s) were added to refs/heads/main by this push:
     new 14560e4d2a5 Clarify FAB and Auth documentation regarding external_db_managers (#69929)
14560e4d2a5 is described below

commit 14560e4d2a590555b76babf5ace52ec2403ddd19
Author: Stephan <31...@users.noreply.github.com>
AuthorDate: Wed Jul 15 18:39:21 2026 +0200

    Clarify FAB and Auth documentation regarding external_db_managers (#69929)
    
    This PR clarifies the related documentation by:
    
    - Replacing the incorrectly used [core] external_db_managers section with [database] external_db_managers.
    - Rewording misleading statements that suggested DB managers are added to the external_db_managers configuration, when they are actually loaded automatically at runtime.
---
 airflow-core/docs/core-concepts/auth-manager/index.rst | 4 ++--
 providers/fab/docs/upgrading.rst                       | 6 +++---
 2 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/airflow-core/docs/core-concepts/auth-manager/index.rst b/airflow-core/docs/core-concepts/auth-manager/index.rst
index 49d761b174b..b821fbfa135 100644
--- a/airflow-core/docs/core-concepts/auth-manager/index.rst
+++ b/airflow-core/docs/core-concepts/auth-manager/index.rst
@@ -257,8 +257,8 @@ Other optional methods
   Override this method if you need to make any action (e.g. create resources, API call) that the auth manager needs.
 * ``get_extra_menu_items``: Provide additional links to be added to the menu in the UI.
 * ``get_db_manager``: If your auth manager requires one or several database managers (see :class:`~airflow.utils.db_manager.BaseDBManager`),
-  their class paths need to be returned as part of this method. By doing so, they will be automatically added to the
-  config ``[database] external_db_managers``.
+  their class paths need to be returned as part of this method. By doing so, Airflow automatically loads the
+  respective database managers.
 
 
 Additional Caveats
diff --git a/providers/fab/docs/upgrading.rst b/providers/fab/docs/upgrading.rst
index 3e861fb1a7e..4a7bf4cfab5 100644
--- a/providers/fab/docs/upgrading.rst
+++ b/providers/fab/docs/upgrading.rst
@@ -25,12 +25,12 @@ Why you need to upgrade
 The FAB provider is a separate package from Airflow and it is released independently. Starting from version 1.3.0, FAB
 can now run its own migrations if you are on Airflow 3. Newer FAB versions can contain database migrations, so you
 must run ``airflow fab-db migrate`` to migrate your database with the schema changes in the FAB version you are
-upgrading to. If ``FABDBManager`` is included in the ``[core] external_db_managers`` configuration, the migrations will
+upgrading to. If ``FABDBManager`` is included in the ``[database] external_db_managers`` configuration, the migrations will
 be run automatically as part of the ``airflow db migrate`` command.
 
 .. note::
-    If FAB auth manager is configured as auth manager in your environment, ``FABDBManager`` is automatically added in the
-    ``[core] external_db_managers`` configuration.
+    If the FAB auth manager is configured as ``[core] auth_manager`` in your environment, Airflow automatically loads
+    ``FABDBManager`` and runs its migrations as part of the ``airflow db migrate`` command.
 
 How to upgrade
 ==============