Skip to content

fix: flip Get started CTA to /first-run (#440) #441

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
melvincarvalho merged 1 commit into from
May 14, 2026
Merged

fix: flip Get started CTA to /first-run (#440) #441

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion src/ui/server-root.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
10 changes: 5 additions & 5 deletions test/server-root.test.js
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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/);
});

Expand Down