Making language spec default page vary based on type of documentation

Author: cesarebernardis

docs/pyagentspec/source/_components/all_components.json

@@ -275,5 +275,15 @@
             {"path": "pyagentspec.a2aagent.A2AConnectionConfig"},
             {"path": "pyagentspec.a2aagent.A2ASessionParameters"}
         ]
+    },
+    {
+        "name": "Adapters",
+        "path": "adapters",
+        "classes": [
+            {"path": "pyagentspec.adapters.autogen.AgentSpecExporter"},
+            {"path": "pyagentspec.adapters.autogen.AgentSpecLoader"},
+            {"path": "pyagentspec.adapters.langgraph.AgentSpecExporter"},
+            {"path": "pyagentspec.adapters.langgraph.AgentSpecLoader"}
+        ]
     }
 ]

docs/pyagentspec/source/agentspec/index.rst

@@ -19,13 +19,23 @@ or create them from object representations with the assurance of conformance to
 
 You can download the Agent Spec technical report at the following :download:`link <../_static/agentspec_technical_report.pdf>`.
 
-You can also find the nightly version of the Agent Spec language specification
-with all the latest updates at :ref:`this link<agentspecspec_nightly>`.
+.. only:: stable
 
-.. toctree::
-   :maxdepth: 2
+    .. toctree::
+        :maxdepth: 2
 
-   Introduction, motivation & vision <intro_and_motivation>
-   Language specification (v25.4.1) <language_spec_25_4_1>
-   Positioning in the agentic ecosystem <positioning>
-   Tracing <tracing>
+        Introduction, motivation & vision <intro_and_motivation>
+        Language specification (v25.4.1) <language_spec_25_4_1>
+        Positioning in the agentic ecosystem <positioning>
+        Tracing <tracing>
+
+.. only:: dev
+
+    .. toctree::
+        :maxdepth: 2
+
+        Introduction, motivation & vision <intro_and_motivation>
+        Language specification (v25.4.1) <language_spec_25_4_1>
+        Language specification (under development) <language_spec_nightly>
+        Positioning in the agentic ecosystem <positioning>
+        Tracing <tracing>

docs/pyagentspec/source/conf.py

@@ -37,10 +37,6 @@
 with open(Path(__file__).parents[3] / "VERSION", "r") as f:
     version_file = f.read().strip()
 
-# The IDE complains, but the tags set exists
-# We add stable as current version, we might add the version switch in the future
-tags.add("stable")  # type: ignore
-
 # The full version, including alpha/beta/rc tags.
 release = pyagentspec.__version__
 
@@ -57,6 +53,13 @@
     else:
         docs_version = stable_release
 
+# The IDE complains, but the tags set exists
+# We add stable as current version, we might add the version switch in the future
+if docs_version == "dev":
+    tags.add("dev")  # type: ignore
+else:
+    tags.add("stable")  # type: ignore
+
 # -- General configuration ---------------------------------------------------
 
 # Add any Sphinx extension module names here, as strings. They can be
@@ -79,6 +82,11 @@
     "sphinx_design",
 ]
 
+if docs_version == "dev":
+    language_spec_file = "language_spec_nightly"
+else:
+    language_spec_file = f"language_spec_{docs_version.replace('.', '_')}"
+
 # Set the variables that should be replaced in the substitution-extensions directives
 rst_prolog = f"""
 .. |release| replace:: {release}
@@ -128,7 +136,7 @@
 autodoc_typehints = "description"
 
 # Redirects
-rediraffe_redirects = {"agentspec/language_spec.rst": "agentspec/language_spec_25_4_1.rst"}
+rediraffe_redirects = {"agentspec/language_spec.rst": f"agentspec/{language_spec_file}.rst"}
 
 
 # -- Options for HTML output -------------------------------------------------