From 31da07dce4a82b179b3c0a0d24a9237fd79a275a Mon Sep 17 00:00:00 2001 From: Cursor Agent Date: Thu, 12 Nov 2026 16:51:45 +0000 Subject: [PATCH 1/4] Refresh landing and harden site responsive shell. Add a brand-first home hero, safe-area and fold/dual-pane CSS, short-landscape compaction, and stronger overflow/touch behavior across the shared docs shell. Co-authored-by: cpp5717 --- site/README.md | 17 +- site/docs/research-decisions.md | 4 +- site/public/docs/index.md | 7 +- site/public/docs/manifest.json | 4 +- site/public/llms-full.txt | 7 +- site/scripts/build.ts | 121 +++++++++-- site/src/site.js | 8 +- site/src/tailwind.css | 349 +++++++++++++++++++++++++++++--- 8 files changed, 453 insertions(+), 64 deletions(-) diff --git a/site/README.md b/site/README.md index 97f0d93..305eee4 100644 --- a/site/README.md +++ b/site/README.md @@ -41,12 +41,17 @@ production HTTP headers. Deployment is a separate operation. ## Design -The approved minimal documentation layout uses a 240px navigation rail, a reading -column, and a 180px outline. Native disclosures replace the rail below 900px and -the outline below 1200px. Article prose uses Inter Variable at 17px and 1.65 line -height. Literal code uses JetBrains Mono at 15px and 1.6 line height without -ligatures. Both fonts are pinned dependencies, copied locally with their -licenses. Only the prose font is preloaded. +The shared documentation shell uses a 240px navigation rail, a reading column, +and a 180px outline. Native disclosures replace the rail below 900px and the +outline below 1200px. The landing page (`index`) adds a brand-first full-bleed +hero before that shell: large **A7** mark, one lede, Get started / Tour CTAs, and +a dominant code plane. Safe-area insets, short-landscape compaction, and +fold / dual-segment spanning rules live in `src/tailwind.css`. + +Article prose uses Inter Variable at 17px and 1.65 line height. Literal code +uses JetBrains Mono at 15px and 1.6 line height without ligatures. Both fonts +are pinned dependencies, copied locally with their licenses. Only the prose +font is preloaded. Light and dark tokens live in `src/tailwind.css`. The initial theme follows the system; explicit preferences apply before paint and persist when storage is diff --git a/site/docs/research-decisions.md b/site/docs/research-decisions.md index b31ff16..36a6cef 100644 --- a/site/docs/research-decisions.md +++ b/site/docs/research-decisions.md @@ -6,7 +6,9 @@ Reviewed 2026-09-19. These decisions implement the user's approved option 2 plan Use a persistent documentation rail, a readable article column, and an optional page outline. Collapse navigation into native disclosures on smaller screens so it works without JavaScript. Separate the guided tour from exhaustive language reference. This applies the distinction between learning and information retrieval in [Diátaxis](https://diataxis.fr/). -No option 2 concept image was located by the initial repository filename search. The written approved plan is the design authority. Existing screenshots under `docs/audits/2026-09-19/browser/` record the previous site, not acceptance of this rebuild. Do not claim a pixel comparison against an unavailable reference. +The 2026-11 landing + responsive pass keeps that IA. The home route adds a brand-first hero (large A7, one sentence, two CTAs, full-bleed code visual) before the shared shell. Responsive hardening covers safe-area insets, short landscape heights, local overflow for tables and code, and progressive fold / viewport-segment dual-pane rules. Fold hardware coverage is only as strong as the CSS APIs the browser exposes; record simulations separately from device claims. + +No option 2 concept image was located by the initial repository filename search. The written approved plan is the design authority for the docs shell. The Project store brief `site-responsive-redesign.md` (approach 3) is the authority for the landing and fold/responsive additions. Existing screenshots under `docs/audits/2026-09-19/browser/` record the previous site, not acceptance of this rebuild. Do not claim a pixel comparison against an unavailable reference. ## Typography diff --git a/site/public/docs/index.md b/site/public/docs/index.md index b01c573..5aca235 100644 --- a/site/public/docs/index.md +++ b/site/public/docs/index.md @@ -6,11 +6,10 @@ summary: An experimental systems language that compiles to Zig and native progra order: 0 --- -# A7 documentation +# A7 -A7 is an experimental, statically typed systems language. Its Python compiler -checks `.a7` source and emits a single Zig file. Zig 0.17.1 builds the native -program. Start below, then read the tour or the language reference. +A7 checks `.a7` source in Python, emits one Zig file, and builds a native program +with Zig 0.17.1. Start below, then read the tour or the language reference. ## Start in two minutes diff --git a/site/public/docs/manifest.json b/site/public/docs/manifest.json index c57f5ce..f11e057 100644 --- a/site/public/docs/manifest.json +++ b/site/public/docs/manifest.json @@ -16,8 +16,8 @@ "sections": [ { "level": 1, - "id": "a7-documentation", - "text": "A7 documentation" + "id": "a7", + "text": "A7" }, { "level": 2, diff --git a/site/public/llms-full.txt b/site/public/llms-full.txt index 4cff57f..3407ada 100644 --- a/site/public/llms-full.txt +++ b/site/public/llms-full.txt @@ -2,11 +2,10 @@ Source: https://code5717.github.io/a7-py/docs/index.md -# A7 documentation +# A7 -A7 is an experimental, statically typed systems language. Its Python compiler -checks `.a7` source and emits a single Zig file. Zig 0.17.1 builds the native -program. Start below, then read the tour or the language reference. +A7 checks `.a7` source in Python, emits one Zig file, and builds a native program +with Zig 0.17.1. Start below, then read the tour or the language reference. ## Start in two minutes diff --git a/site/scripts/build.ts b/site/scripts/build.ts index f5d8406..f48208c 100644 --- a/site/scripts/build.ts +++ b/site/scripts/build.ts @@ -28,6 +28,81 @@ function navigation(active: string) { .join("")}`, ).join(""); } +function applyAliases(doc: Doc, articleHtml: string) { + let html = articleHtml; + for (const id of doc.aliases) { + const target = + id === "exit-codes" ? "diagnostics-and-exit-codes" : doc.headings[0].id; + html = html.replace( + new RegExp(`(