Skip to content

Reorder landing page sections for clearer user flow #404

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
zz-plant merged 1 commit into from
Jan 15, 2026
Merged

Reorder landing page sections for clearer user flow #404

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
4 changes: 2 additions & 2 deletions src/content/start-here.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -35,10 +35,10 @@
]
},
"anchorLinks": [
{ "href": "#framing", "label": "What this is" },
{ "href": "#routes", "label": "Choose your path" },
{ "href": "#artifacts", "label": "Preview outputs" },
{ "href": "#quick-start", "label": "Quick-start guides" },
{ "href": "#framing", "label": "What this is" },
{ "href": "#artifacts", "label": "Preview outputs" },
{ "href": "#decision-guide", "label": "Decision guide" },
{ "href": "#studio", "label": "How Studio fits" },
{ "href": "#cta", "label": "Talk to the team" }
Expand Down
150 changes: 75 additions & 75 deletions src/pages/index.astro
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -48,6 +48,81 @@ const { pageTitle, pageDescription } = homeEntry.data;
</div>
</section>

<SectionBlock
id="audience"
eyebrow="Audience selector"
title="Route to the right artifacts in one click."
description="Each audience path reorders the stack to match the work you do."
variant="alt"
>
<CardGrid className="grid--two">
<CardItem
title="I am building an automated system or agent"
description="Fast path, mechanisms, and concrete implementation examples."
>
<ul class="muted">
<li>
<a href="/fast-path">Fast path</a>
</li>
<li>
<a href="/mechanisms">Mechanisms</a>
</li>
<li>
<a href="/examples">Worked examples</a>
</li>
</ul>
</CardItem>
<CardItem
title="I am auditing or governing a system"
description="Evidence, bindings, and minimum enforceable requirements."
>
<ul class="muted">
<li>
<a href="/evidence-packs">Evidence packs</a>
</li>
<li>
<a href="/bindings">Binding vectors</a>
</li>
<li>
<a href="/standards">Minimum binding sets</a>
</li>
</ul>
</CardItem>
<CardItem
title="I am writing policy or procurement language"
description="Standards, where they bind, and enforceable clauses."
>
<ul class="muted">
<li>
<a href="/standards">Standards + clauses</a>
</li>
<li>
<a href="/bindings#procurement">Procurement language</a>
</li>
<li>
<a href="/anti-weaponization">Anti-weaponization constraints</a>
</li>
</ul>
</CardItem>
<CardItem
title="I am researching or teaching"
description="Research, glossary anchors, and mapping artifacts."
>
<ul class="muted">
<li>
<a href="/research">Research</a>
</li>
<li>
<a href="/glossary">Glossary</a>
</li>
<li>
<a href="/field-notes">Field notes</a>
</li>
</ul>
</CardItem>
</CardGrid>
</SectionBlock>

<SectionBlock
id="outputs"
eyebrow="What it produces"
Expand Down Expand Up @@ -199,79 +274,4 @@ const { pageTitle, pageDescription } = homeEntry.data;
<li>Does not require organizational buy-in to use.</li>
</ul>
</SectionBlock>

<SectionBlock
id="audience"
eyebrow="Audience selector"
title="Route to the right artifacts in one click."
description="Each audience path reorders the stack to match the work you do."
variant="alt"
>
<CardGrid className="grid--two">
<CardItem
title="I am building an automated system or agent"
description="Fast path, mechanisms, and concrete implementation examples."
>
<ul class="muted">
<li>
<a href="/fast-path">Fast path</a>
</li>
<li>
<a href="/mechanisms">Mechanisms</a>
</li>
<li>
<a href="/examples">Worked examples</a>
</li>
</ul>
</CardItem>
<CardItem
title="I am auditing or governing a system"
description="Evidence, bindings, and minimum enforceable requirements."
>
<ul class="muted">
<li>
<a href="/evidence-packs">Evidence packs</a>
</li>
<li>
<a href="/bindings">Binding vectors</a>
</li>
<li>
<a href="/standards">Minimum binding sets</a>
</li>
</ul>
</CardItem>
<CardItem
title="I am writing policy or procurement language"
description="Standards, where they bind, and enforceable clauses."
>
<ul class="muted">
<li>
<a href="/standards">Standards + clauses</a>
</li>
<li>
<a href="/bindings#procurement">Procurement language</a>
</li>
<li>
<a href="/anti-weaponization">Anti-weaponization constraints</a>
</li>
</ul>
</CardItem>
<CardItem
title="I am researching or teaching"
description="Research, glossary anchors, and mapping artifacts."
>
<ul class="muted">
<li>
<a href="/research">Research</a>
</li>
<li>
<a href="/glossary">Glossary</a>
</li>
<li>
<a href="/field-notes">Field notes</a>
</li>
</ul>
</CardItem>
</CardGrid>
</SectionBlock>
</BaseLayout>
90 changes: 45 additions & 45 deletions src/pages/start-here/index.astro
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -75,6 +75,26 @@ const recommendedDetails = recommendedCard
{hero.deliverables.map((item) => <li>{item}</li>)}
</ul>

<SectionBlock
id="framing"
eyebrow={framing.eyebrow}
title={framing.title}
description={framing.description}
>
<CardGrid className="grid--two">
<CardItem title="This page is" descriptionTone="default">
<ul class="muted">
{framing.isList.map((item) => <li>{item}</li>)}
</ul>
</CardItem>
<CardItem title="This page is not" descriptionTone="default">
<ul class="muted">
{framing.isNotList.map((item) => <li>{item}</li>)}
</ul>
</CardItem>
</CardGrid>
</SectionBlock>

<SectionBlock
id="routes"
eyebrow={routes.eyebrow}
Expand Down Expand Up @@ -115,37 +135,6 @@ const recommendedDetails = recommendedCard
</CardGrid>
</SectionBlock>

<SectionBlock
id="artifacts"
eyebrow={artifacts.eyebrow}
title={artifacts.title}
description={artifacts.description}
variant="alt"
>
<CardGrid className="grid--two">
{
artifacts.previews.map((preview) => (
<CardItem
title={preview.title}
description={preview.description}
descriptionTone="default"
>
<p class="muted">{preview.note}</p>
<div slot="footer" class="card__footer">
<a
class="button primary button--compact"
href={preview.href}
aria-label={preview.label}
>
{preview.label}
</a>
</div>
</CardItem>
))
}
</CardGrid>
</SectionBlock>

<SectionBlock
id="quick-start"
eyebrow={quickStart.eyebrow}
Expand Down Expand Up @@ -175,22 +164,33 @@ const recommendedDetails = recommendedCard
</SectionBlock>

<SectionBlock
id="framing"
eyebrow={framing.eyebrow}
title={framing.title}
description={framing.description}
id="artifacts"
eyebrow={artifacts.eyebrow}
title={artifacts.title}
description={artifacts.description}
variant="alt"
>
<CardGrid className="grid--two">
<CardItem title="This page is" descriptionTone="default">
<ul class="muted">
{framing.isList.map((item) => <li>{item}</li>)}
</ul>
</CardItem>
<CardItem title="This page is not" descriptionTone="default">
<ul class="muted">
{framing.isNotList.map((item) => <li>{item}</li>)}
</ul>
</CardItem>
{
artifacts.previews.map((preview) => (
<CardItem
title={preview.title}
description={preview.description}
descriptionTone="default"
>
<p class="muted">{preview.note}</p>
<div slot="footer" class="card__footer">
<a
class="button primary button--compact"
href={preview.href}
aria-label={preview.label}

@gemini-code-assist gemini-code-assist Bot Jan 15, 2026

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

The aria-label attribute here is redundant because its value is the same as the link's text content. When link text is already descriptive, an aria-label is not necessary. Screen readers will prioritize the aria-label, so while this doesn't cause a functional issue, removing it simplifies the code and adheres to accessibility best practices.

>
{preview.label}
</a>
</div>
</CardItem>
))
}
</CardGrid>
</SectionBlock>

Expand Down