feat(docs): add /docs/ landing page and drop spec forwarders.

/docs/ is now a Zensical-built landing page at docs/docs/index.md with a
section for execution-specs linking to the Amsterdam fork docs. The old
/docs/ and /docs/spec/ forwarders are removed since the site is not live;
only the /docs/default/ permalink remains for stable cross-rollover links.

Author: danceratopz

.github/workflows/deploy.yml

@@ -9,14 +9,12 @@
 #   - workflow_dispatch: Manual trigger for testing/recovery
 #
 # Site structure at steel.ethereum.foundation:
-#   /                             - Zensical site
-#   /docs/                        - Forwards to /docs/default/
-#   /docs/spec/                   - Forwards to /docs/default/spec/
-#   /docs/default/                - Permalink; redirects to current default branch
-#   /docs/default/spec/           - Permalink; redirects to current default branch spec
-#   /docs/<branch>/               - Branch-specific docs
+#   /                              - Zensical site
+#   /docs/                         - Zensical landing page (docs/docs/index.md)
+#   /docs/default/                 - Permalink; redirects to current default branch
+#   /docs/<branch>/                - Branch-specific docs
 #   /docs/<branch>/specs/reference - Branch-specific spec
-#   /docs/versions.json           - Version manifest
+#   /docs/versions.json            - Version manifest
 
 name: Build and Deploy
 

docs/docs/index.md

@@ -0,0 +1,7 @@
+# Documentation
+
+## execution-specs
+
+The [Ethereum execution-layer specification](https://github.com/ethereum/execution-specs).
+
+- [Amsterdam](/docs/forks/amsterdam/)

scripts/assemble-docs.py

@@ -6,11 +6,10 @@
 
 1. Injects the custom version selector <script> tag into all HTML files.
 2. Generates versions.json (flat array with url fields).
-3. Generates redirect index.html files:
-   - /docs/default/ and /docs/default/spec/ are stable permalinks that track
-     the current default branch, so external links survive the rollover from
-     e.g. forks/amsterdam to forks/bogota.
-   - /docs/ and /docs/spec/ forward to those permalinks for backward compat.
+3. Generates /docs/default/ — a stable permalink that tracks the current
+   default branch, so external links survive the rollover from e.g.
+   forks/amsterdam to forks/bogota.
+   /docs/ itself is the Zensical-built landing page and is not overwritten.
 
 Usage (from repo root):
     uv run scripts/assemble-docs.py site/docs \\
@@ -110,30 +109,19 @@ def generate_versions_json(
 
 
 def generate_redirects(docs_dir: Path, default_branch: str) -> None:
-    """Generate permalink redirects under docs/default/ and forwarders at docs root.
+    """Generate the /docs/default/ permalink redirect.
 
-    /docs/default/ and /docs/default/spec/ are the stable permalinks — they
-    track the current default branch and survive its rollover. /docs/ and
-    /docs/spec/ forward through the permalinks so the old URLs keep working.
+    /docs/default/ tracks the current default branch so external links survive
+    the rollover from e.g. forks/amsterdam to forks/bogota.
+
+    /docs/ itself is the Zensical-built landing page (docs/docs/index.md) and
+    is intentionally not written here so we don't overwrite it.
     """
-    branch_url = f"/docs/{default_branch}/"
-    branch_spec_url = f"/docs/{default_branch}/specs/reference/"
-    targets = [
-        # Permalinks: /docs/default/... -> current default branch.
-        (docs_dir / "default" / "index.html", branch_url, default_branch),
-        (
-            docs_dir / "default" / "spec" / "index.html",
-            branch_spec_url,
-            f"{default_branch}/specs/reference",
-        ),
-        # Forwarders: /docs/ and /docs/spec/ -> /docs/default/...
-        (docs_dir / "index.html", "/docs/default/", "default"),
-        (docs_dir / "spec" / "index.html", "/docs/default/spec/", "default/spec"),
-    ]
-    for dest, url, label in targets:
-        dest.parent.mkdir(parents=True, exist_ok=True)
-        dest.write_text(REDIRECT_TEMPLATE.format(url=url, label=label))
-        print(f"Generated redirect: {dest.relative_to(docs_dir)} -> {url}")
+    dest = docs_dir / "default" / "index.html"
+    url = f"/docs/{default_branch}/"
+    dest.parent.mkdir(parents=True, exist_ok=True)
+    dest.write_text(REDIRECT_TEMPLATE.format(url=url, label=default_branch))
+    print(f"Generated redirect: {dest.relative_to(docs_dir)} -> {url}")
 
 
 def main() -> None:

zensical.toml

@@ -49,6 +49,7 @@ nav = [
     { "About" = "about.md" },
     { "Responsibilities" = "responsibilities.md" },
     { "Team" = "team.md" },
+    { "Docs" = "docs/index.md" },
     { "Blog" = [
         "blog/2025-11-27_osaka_mainnet_tests.md",
         "blog/2025-11-04_weld_final.md",