[airflow] branch master updated: Update wording in upgrading documentation (#13862)

[po...@apache.org]

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

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


The following commit(s) were added to refs/heads/master by this push:
     new 32d2c25  Update wording in upgrading documentation (#13862)
32d2c25 is described below

commit 32d2c25e2dd1fd069f51bdfdd79595f12047a867
Author: Jarek Potiuk <ja...@polidea.com>
AuthorDate: Mon Feb 1 12:54:06 2021 +0100

    Update wording in upgrading documentation (#13862)
    
    * Update wording in upgrading documentation
    
    * Update docs/apache-airflow/upgrading-to-2.rst
    
    Co-authored-by: Tomek Urbaszek <to...@polidea.com>
    
    * Update docs/apache-airflow/upgrading-to-2.rst
    
    Co-authored-by: Vikram Koka <vi...@astronomer.io>
    
    Co-authored-by: Tomek Urbaszek <to...@polidea.com>
    Co-authored-by: Vikram Koka <vi...@astronomer.io>
---
 docs/apache-airflow/upgrading-to-2.rst | 16 ++++++++++++----
 1 file changed, 12 insertions(+), 4 deletions(-)

diff --git a/docs/apache-airflow/upgrading-to-2.rst b/docs/apache-airflow/upgrading-to-2.rst
index 48e9894..876d2cd 100644
--- a/docs/apache-airflow/upgrading-to-2.rst
+++ b/docs/apache-airflow/upgrading-to-2.rst
@@ -286,10 +286,18 @@ When DAGs are initialized with the ``access_control`` variable set, any usage of
 .. warning::
     Breaking change
 
-    Previously we were using two versions of UI, which were hard to maintain as we need to implement/update the same feature
-    in both versions. With this release we have removed the older UI in favor of Flask App Builder RBAC UI. No need to set the
-    RBAC UI explicitly in the configuration now as this is the only default UI. We did it to avoid
-    the huge maintenance burden of two independent user interfaces
+    Previously we were using two versions of the UI:
+        - non-RBAC UI
+        - Flask App Builder RBAC UI
+
+    This was difficult to maintain, because it meant we
+    had to implement/update features in two places. With this release, we have removed the older UI in
+    favor of the Flask App Builder RBAC UI, reducing a huge maintenance burden.
+    There is no longer a need to set the RBAC UI explicitly in the configuration,
+    as it is the only default UI.
+
+    If you previously used non-RBAC UI, you have to switch to the new RBAC-UI and create users to be able
+    to access Airflow's webserver. For more details on CLI to create users see :doc:`cli-and-env-variables-ref`
 
 Please note that that custom auth backends will need re-writing to target new FAB based UI.