Confgure "suggest a change" links properly (apache#49702)

After moving the docs, the links to "Suggest a change" for airflow,
docker-compose and helm-chart lead to a wrong URL. This PR fixes it.

We also do not use analytics any more so configuration for it is not
needed any more.

Fixes: apache#49694

Author: potiuk

airflow-core/docs/conf.py

@@ -67,8 +67,6 @@
 SYSTEM_TESTS_DIR: pathlib.Path | None
 SYSTEM_TESTS_DIR = AIRFLOW_REPO_ROOT_PATH / "airflow-core" / "tests" / "system" / "core"
 
-conf_py_path = f"/docs/{PACKAGE_NAME}/"
-
 os.environ["AIRFLOW_PACKAGE_NAME"] = PACKAGE_NAME
 
 # Hack to allow changing for piece of the code to behave differently while
@@ -238,6 +236,7 @@ def add_airflow_core_exclude_patterns_to_sphinx(exclude_patterns: list[str]):
 # html theme options
 html_theme_options: dict[str, Any] = get_html_theme_options()
 
+conf_py_path = "/airflow-core/docs/"
 # A dictionary of values to pass into the template engine's context for all pages.
 html_context = get_html_context(conf_py_path)
 

chart/docs/conf.py

@@ -64,8 +64,6 @@
 CHART_ROOT_PATH = AIRFLOW_REPO_ROOT_PATH / "chart"
 CHART_DOC_PATH = CHART_ROOT_PATH / "docs"
 CHART_STATIC_PATH = CHART_DOC_PATH / "static"
-conf_py_path = f"/docs/{PACKAGE_NAME}/"
-
 os.environ["AIRFLOW_PACKAGE_NAME"] = PACKAGE_NAME
 
 CHART_YAML_FILE_PATH = CHART_ROOT_PATH / "Chart.yaml"
@@ -134,6 +132,10 @@
 
 html_title = f"{PACKAGE_NAME} Documentation"
 
+conf_py_path = "/chart/docs/"
+# A dictionary of values to pass into the template engine's context for all pages.
+html_context = get_html_context(conf_py_path)
+
 # A shorter title for the navigation bar.  Default is the same as html_title.
 html_short_title = ""
 

devel-common/pyproject.toml

@@ -74,7 +74,7 @@ dependencies = [
     "rich-click>=1.7.1",
     "click>=8.1.8",
     "docutils>=0.21",
-    "sphinx-airflow-theme>=0.1.0",
+    "sphinx-airflow-theme>=0.2.2",
     "sphinx-argparse>=0.4.0",
     "sphinx-autoapi>=3",
     "sphinx-autobuild>=2024.10.2",

devel-common/src/docs/provider_conf.py

@@ -80,7 +80,6 @@
 BASE_PROVIDER_SRC_PATH = PROVIDER_PATH / "src" / "airflow"
 PACKAGE_VERSION = CURRENT_PROVIDER["versions"][0]
 SYSTEM_TESTS_DIR = PROVIDER_PATH / "tests" / "system"
-conf_py_path = f"/providers/{PACKAGE_ID.replace('.', '/')}/docs/"
 
 # Adds to environment variables for easy access from other plugins like airflow_intersphinx.
 os.environ["AIRFLOW_PACKAGE_NAME"] = PACKAGE_NAME
@@ -221,6 +220,8 @@
 
 html_theme_options: dict[str, Any] = get_html_theme_options()
 
+
+conf_py_path = f"/providers/{PACKAGE_ID.replace('.', '/')}/docs/"
 # A dictionary of values to pass into the template engine's context for all pages.
 html_context = get_html_context(conf_py_path)
 

devel-common/src/docs/utils/conf_constants.py

@@ -150,10 +150,6 @@ def get_html_theme_options():
 
 def get_html_context(conf_py_path: str):
     return {
-        # Google Analytics ID.
-        # For more information look at:
-        # https://github.com/readthedocs/sphinx_rtd_theme/blob/master/sphinx_rtd_theme/layout.html#L222-L232
-        "theme_analytics_id": "UA-140539454-1",
         # Variables used to build a button for editing the source code
         #
         # The path is created according to the following template:

docker-stack-docs/conf.py

@@ -62,8 +62,6 @@
 
 PACKAGE_VERSION: str = "stable"
 
-conf_py_path = f"/docs/{PACKAGE_NAME}/"
-
 # Adds to environment variables for easy access from other plugins like airflow_intersphinx.
 os.environ["AIRFLOW_PACKAGE_NAME"] = PACKAGE_NAME
 
@@ -155,6 +153,7 @@
 
 html_theme_options: dict[str, Any] = get_html_theme_options()
 
+conf_py_path = "/docker-stack-docs/"
 # A dictionary of values to pass into the template engine's context for all pages.
 html_context = get_html_context(conf_py_path)
 

providers-summary-docs/conf.py

@@ -60,8 +60,6 @@
 PACKAGE_NAME = "apache-airflow-providers"
 PROVIDERS_SUMMARY_DOCS_PATH = AIRFLOW_REPO_ROOT_PATH / "providers-summary-docs"
 
-conf_py_path = f"/docs/{PACKAGE_NAME}/"
-
 os.environ["AIRFLOW_PACKAGE_NAME"] = PACKAGE_NAME
 
 PACKAGE_VERSION = "stable"
@@ -166,6 +164,7 @@
 
 html_theme_options: dict[str, Any] = get_html_theme_options()
 
+conf_py_path = "/providers-summary-docs/"
 # A dictionary of values to pass into the template engine's context for all pages.
 html_context = get_html_context(conf_py_path)