From 6ed63492f16af1338c55e04995220978620205fa Mon Sep 17 00:00:00 2001 From: snapsynapse <57973674+snapsynapse@users.noreply.github.com> Date: Wed, 23 Sep 2026 22:00:57 -0600 Subject: [PATCH] Fix mobile overflow, symlink-source wording, and loading claim Resolves the three findings in the 2026-09-22 presentation-readiness handoff, reproduced 2026-09-24 at 065b315. - docs/index.html: code grids use minmax(0, 1fr) tracks and grid children set min-width: 0, so long commands no longer widen the page (848 px at 320/390/768 before; equal to the viewport after). Wide pre blocks and the link map scroll inside keyboard-focusable regions with a visible focus outline. The generated tools block is unchanged. - docs/index.html: hook and Zero codegen copy say every linked path holds the same bytes, and that each tool decides when it rereads them, instead of "every tool sees it instantly". - README.md: sync rejects a symlinked source by default and changes nothing; --force links to it anyway and check still reports it. Verified against the v0.6.0 release binary. - Landing modified dates and root sitemap lastmod move to 2026-09-23. - docs_contract_test.go: byline date expectation follows the page, and the config-example matcher accepts attributes on 
.

Validation: go test ./..., go test -tags=integration ., go vet,
update-docs -check, check-search (0 defects), release contract; local
render at 320/390/768/1280 has no page overflow; axe 0 violations and
0 incomplete before and after.

Co-Authored-By: Claude Opus 5.5 
---
 CHANGELOG.md          |  6 ++++++
 README.md             |  2 +-
 docs/index.html       | 49 ++++++++++++++++++++++---------------------
 docs/sitemap.xml      |  2 +-
 docs_contract_test.go |  4 ++--
 5 files changed, 35 insertions(+), 28 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index cd9135f..cc416e1 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -7,6 +7,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+### Documentation
+
+- Website no longer scrolls horizontally on phones and tablets: code grids use `minmax(0, 1fr)` tracks, and wide commands and the link map scroll inside keyboard-focusable regions.
+- Website hero and feature copy distinguish shared file contents from when each tool rereads them.
+- README states that `sync` rejects a symlinked `source` by default, and what `--force` does instead.
+
 ## [0.6.0] - 2026-09-05
 
 ### Fixed
diff --git a/README.md b/README.md
index 7e3f23b..881b318 100644
--- a/README.md
+++ b/README.md
@@ -367,7 +367,7 @@ links:
 ```
 
 Notes:
-- **`source` must be a real file**, not a symlink (Agentlink warns if it is).
+- **`source` must be a real file**, not a symlink. By default `agentlink sync` refuses a symlinked source, exits with an error, and changes nothing. `--force` links to it anyway, creating a chain that `agentlink check` still reports as a problem; point `source` at the real file instead.
 - Paths in `links` are relative to the project root.
 - To layer tool-specific guidance, omit that tool's path from `links` and keep its wrapper as a real committed file.
 
diff --git a/docs/index.html b/docs/index.html
index 1f3c802..bdda39c 100644
--- a/docs/index.html
+++ b/docs/index.html
@@ -31,7 +31,7 @@
   
   
   
-  
+  
   
   
   
@@ -69,7 +69,7 @@
     "operatingSystem": "macOS, Linux",
     "softwareVersion": "0.6.0",
     "datePublished": "2026-04-14",
-    "dateModified": "2026-09-05",
+    "dateModified": "2026-09-23",
     "license": "https://opensource.org/licenses/MIT",
     "image": "https://agentlink.run/imgs/og.png",
     "author": {
@@ -103,7 +103,7 @@
     "url": "https://agentlink.run/",
     "mainEntityOfPage": { "@type": "WebPage", "@id": "https://agentlink.run/" },
     "datePublished": "2026-04-14",
-    "dateModified": "2026-09-05",
+    "dateModified": "2026-09-23",
     "author": {
       "@type": "Person",
       "name": "Sam Rogers",
@@ -397,12 +397,12 @@
     /* Code blocks */
     .code-grid {
       display: grid;
-      grid-template-columns: 1fr 1fr;
+      grid-template-columns: repeat(2, minmax(0, 1fr));
       gap: 1.5rem;
       margin-top: 1.5rem;
     }
-    .code-grid.single { grid-template-columns: 1fr; }
-    .code-block { text-align: left; }
+    .code-grid.single { grid-template-columns: minmax(0, 1fr); }
+    .code-block { text-align: left; min-width: 0; }
     .code-block h3 { font-size: 0.95rem; margin-bottom: 0.75rem; }
     .code-block .annotation {
       font-size: 0.85rem;
@@ -441,6 +441,7 @@
     .support-table code { white-space: normal; }
     .support-table th[scope="row"] { text-transform: none; letter-spacing: normal; font-size: 0.9rem; }
     .support-table:focus-visible { outline: 2px solid var(--accent); outline-offset: 3px; }
+    pre:focus-visible, .linkmap:focus-visible { outline: 2px solid var(--accent); outline-offset: 2px; }
 
     /* Footer */
     footer {
@@ -466,7 +467,7 @@
     @media (max-width: 768px) {
       h1 { font-size: 2rem; }
       .hero { padding: 3rem 0 2.5rem; }
-      .code-grid { grid-template-columns: 1fr; }
+      .code-grid { grid-template-columns: minmax(0, 1fr); }
       .pillars { grid-template-columns: 1fr; }
       nav .links { display: none; }
       nav .links.mobile-compact { display: flex; gap: 0.75rem; }
@@ -526,15 +527,15 @@ 
One AGENTS.md, every tool.

       
       Published 
       
-      Last updated 
+      Last updated 
       
       v0.6.0
       
       MIT
     

-    
Different tools want different files at project root: AGENTS.md, CLAUDE.md, GEMINI.md, .cursorrules. There’s no standard, and waiting for one is expensive. Agentlink keeps them in sync through symlinks. Edit one, every tool sees the change.

+    
Different tools want different files at project root: AGENTS.md, CLAUDE.md, GEMINI.md, .cursorrules. There’s no standard, and waiting for one is expensive. Agentlink keeps them in sync through symlinks. Edit one file and every linked path holds the same text; each tool still decides when it rereads it.

 
-