Hello,

In Airflow 2, we've moved some configuration options to the new section. We also changed the names of some of the configuration options. This is confusing for users who are familiar with the old option and section names.  It would be great if we could add information to the documentation that points to the new name of the options.

https://github.com/apache/airflow/blob/8f48f12128e0d985c6de2603902524859fecbca8/airflow/configuration.py#L139-L169

> 'The {old} option in [{section}] has been renamed to {new}
> 'The {old_key} option in [{old_section}] has been moved to the {new_key} option in '
> '[{new_section}]

Best regards,
Kamil Breguła

docs/conf.py
if os.path.isdir(filepath):
        result = filepath
    elif os.path.isfile(filepath) and filepath.endswith('/__init__.py'):
        result = filepath.rpartition("/")[0]
    else:
        result = filepath.rpartition(".")[0]
    result += "/index.rst"
    result = f"_api/{os.path.relpath(result, ROOT_DIR)}"
    return result
if PACKAGE_NAME == 'apache-airflow':
    
    
    _allowed_top_level = ("exceptions.py",)
    for path in glob.glob(f"{ROOT_DIR}/airflow/*"):
        name = os.path.basename(path)
        if os.path.isfile(path) and not path.endswith(_allowed_top_level):
            exclude_patterns.append(f"_api/airflow/{name.rpartition('.')[0]}")
        browsable_packages = ["operators", "hooks", "sensors", "providers", "executors", "models", "secrets"]
        if os.path.isdir(path) and name not in browsable_packages:
            exclude_patterns.append(f"_api/airflow/{name}")
else:
    exclude_patterns.extend(
        _get_rst_filepath_from_path(f) for f in glob.glob(f"{PACKAGE_DIR}/**/example_dags/**/*.py")
    )
templates_path = ['templates']
keep_warnings = True
html_theme = 'sphinx_airflow_theme'