From 67a0b62cd8ffe989713b94a5e8b61282becee68d Mon Sep 17 00:00:00 2001
From: Liam Girdwood <liam.r.girdwood@linux.intel.com>
Date: Sun, 13 Sep 2026 20:07:13 +0100
Subject: [PATCH] doc: redirect landing page and logo link to introduction

- Set docutils meta http-equiv Refresh and JavaScript replace in index.rst
  to redirect /latest/ and /latest/index.html directly to introduction/index.html.
- Configure pydata theme logo link to introduction/index so clicking the header
  logo navigates directly to the Introduction page.
- Update scripts/publish-index.html to redirect root https://thesofproject.github.io/
  directly to latest/introduction/index.html.

Signed-off-by: Liam Girdwood <liam.r.girdwood@linux.intel.com>
---
 conf.py                    |  3 +++
 index.rst                  | 40 +++++++++++++-------------------------
 scripts/publish-index.html |  7 +++++--
 3 files changed, 21 insertions(+), 29 deletions(-)

diff --git a/conf.py b/conf.py
index 640bc215..14652328 100755
--- a/conf.py
+++ b/conf.py
@@ -153,6 +153,9 @@
     import pydata_sphinx_theme
     html_theme = "pydata_sphinx_theme"
     html_theme_options = {
+        "logo": {
+            "link": "introduction/index",
+        },
         "github_url": "https://github.com/thesofproject/sof",
         "external_links": [
             {"name": "SOF Project Website", "url": "https://sofproject.org"}
diff --git a/index.rst b/index.rst
index db782943..cd3aebe7 100644
--- a/index.rst
+++ b/index.rst
@@ -1,38 +1,23 @@
-.. _SOF_home:
-
-Sound Open Firmware Documentation
-#################################
+.. meta::
+   :http-equiv=Refresh: 0; url=introduction/index.html
 
-Welcome to the **Sound Open Firmware (SOF)** technical documentation portal (version |version|).
+.. raw:: html
 
-Sound Open Firmware is a permissively licensed, open-source audio DSP firmware, SDK, and Linux/Zephyr audio framework providing vendor-independent, transparent audio processing infrastructure across diverse DSP hardware architectures.
+   <script type="text/javascript">
+       window.location.replace("introduction/index.html");
+   </script>
 
-.. note::
-   Looking for high-level project announcements, community blogs, and events? Visit the main `SOF Project Website <https://sofproject.org>`_.
+.. _SOF_home:
 
-Overview & Quick Navigation
-***************************
+Sound Open Firmware Documentation
+#################################
 
-* :ref:`Getting Started <getting_started>`
-    Set up your build environment, compile firmware for target platforms, and run tests in simulation.
-* :ref:`Architecture & System Design <architectures>`
-    End-to-end system design: Host Linux ASoC drivers, IPC protocols (IPC3/IPC4), Zephyr RTOS integration, and memory paging.
-* :ref:`Supported Platforms Matrix <platforms>`
-    Hardware compatibility list spanning Intel CAVS/ACE, AMD, NXP, MediaTek, Teensy 4.1, and ESP32-P4 bridges.
-* :ref:`Audio Algorithms & Features <algos>`
-    Processing modules catalog: Volume, Mixer, SRC, EQ, DRC, AEC, Beamforming, WoV, AAC/MP3 VFPU, and Steam Audio.
-* :ref:`Developer Guides <developer_guides>`
-    Deep-dives into Topology 2, LLEXT dynamic module loading, real-time trace probing, and debugging.
-* :ref:`API Reference <api>`
-    Doxygen-generated C API documentation for firmware interfaces, components, and driver ABIs.
-* :ref:`Frequently Asked Questions (FAQ) <faq>`
-    Quick answers to architectural, algorithmic, hardware compatibility, simulation, and licensing questions.
+.. raw:: html
 
-Documentation Sections
-**********************
+   <p>Redirecting to <a href="introduction/index.html">Introduction to the SOF Project</a>...</p>
 
 .. toctree::
-   :maxdepth: 1
+   :hidden:
 
    SOF Project Website <https://sofproject.org>
    introduction/index.rst
@@ -48,3 +33,4 @@ Documentation Sections
    api/index.rst
    presentations/index.rst
    faq/index.rst
+
diff --git a/scripts/publish-index.html b/scripts/publish-index.html
index 1f07feec..20d954dd 100644
--- a/scripts/publish-index.html
+++ b/scripts/publish-index.html
@@ -1,10 +1,13 @@
 <html>
 <head>
 <title>SOF Project documentation</title>
-<meta http-equiv="refresh" content="0; URL=latest/index.html">
+<meta http-equiv="refresh" content="0; URL=latest/introduction/index.html">
 <meta name="keywords" content="automatic redirection">
+<script type="text/javascript">
+    window.location.replace("latest/introduction/index.html");
+</script>
 </head>
 <body>
-Please visit the <a href="/latest/">latest SOF documentation</a>
+Please visit the <a href="latest/introduction/index.html">latest SOF documentation</a>
 </body>
 </html>