From 1ff772ff571d7e83af451728b4a415585911b60c Mon Sep 17 00:00:00 2001
From: Melvin Carvalho <melvincarvalho@gmail.com>
Date: Thu, 14 May 2026 10:48:35 +0200
Subject: [PATCH] fix: flip Get started CTA from /introduction to /first-run
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

The new First Run docs page (JavaScriptSolidServer/docs#14) is a
friendlier destination for the seeded landing's primary CTA — walks
through the actual next steps after install (Mashlib, sign up/in
walkthrough, OIDC client connection, feature flags, customising the
landing). The Introduction page is reference-y by comparison.

Closes #440.
---
 src/ui/server-root.html  |  2 +-
 test/server-root.test.js | 10 +++++-----
 2 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/src/ui/server-root.html b/src/ui/server-root.html
index f5733cc5..ca6533f0 100644
--- a/src/ui/server-root.html
+++ b/src/ui/server-root.html
@@ -62,7 +62,7 @@ <h1>Welcome</h1>
     <p class="explainer">This is a Solid pod server. Solid is an open standard for personal data — your data lives in pods you own, and apps connect to it.</p>
 
     <div class="actions">
-      <a href="https://jss.live/docs/getting-started/introduction" class="btn btn-primary">Get started →</a>
+      <a href="https://jss.live/docs/getting-started/first-run" class="btn btn-primary">Get started →</a>
       <!-- IdP links are written page-relative (no leading slash) so they
            resolve against document base, surviving reverse-proxy mounts
            at a path prefix (e.g. https://example/jss/). Origin-root
diff --git a/test/server-root.test.js b/test/server-root.test.js
index 80039011..8e9713cd 100644
--- a/test/server-root.test.js
+++ b/test/server-root.test.js
@@ -132,12 +132,12 @@ describe('renderServerRoot', () => {
     assert.doesNotMatch(html, /class="info"/);
   });
 
-  it('always emits the Get started button pointing at the docs introduction', () => {
+  it('always emits the Get started button pointing at the docs First Run page', () => {
     const html = renderServerRoot({ version: '1.0.0' });
-    // The canonical URL is the introduction page, not the category.
-    // Docusaurus 3 doesn't auto-generate a category index page, so
-    // /docs/getting-started/ would 404. Link to the real document.
-    assert.match(html, /href="https:\/\/jss\.live\/docs\/getting-started\/introduction"/);
+    // First Run is the friendly "you just installed it, now what?"
+    // walkthrough — better destination for a first-time installer than
+    // the encyclopedic Introduction page. See #440.
+    assert.match(html, /href="https:\/\/jss\.live\/docs\/getting-started\/first-run"/);
     assert.match(html, /Get started/);
   });