Skip to content

Homepage has no navigation into the SDK docs (only a footer CTA to /spec) #16

@nficano

Description

@nficano

Summary

The marketing homepage exposes no navigation to the documentation. HomeHeader.vue contains only the ARCP logo (links to /) and three non-interactive <span> tags (Internet-Draft / Standards Track / v1.1). The only outbound content link on the entire page is the footer CTA "Read the specification" → /spec/draft-arcp-1.1. A visitor who lands on / and wants, say, the Python or TypeScript SDK docs has no signposted path — they must scroll to the footer, enter the spec, then discover the language switcher in the docs sidebar.

Location(s)

  • / (homepage) — app/components/HomeHeader.vue, app/pages/index.vue
  • All breakpoints

Severity

P3 — IA / discoverability gap (not a dead end; SDK docs are reachable in ~2 clicks via spec → language switcher).

Evidence

  • HomeHeader.vue: renders <NuxtLink to="/">{{ name }}</NuxtLink> + v-for over tags as plain <span> (no links).
  • pages/index.vue: only outbound link is home.cta/spec/draft-arcp-1.1; no top nav, no GitHub link, no SDK index.
  • Screenshot: .audit/evidence/audit-home-1280.png — header right shows three muted tag labels, no nav.

Suggested fix

Add primary navigation to the homepage header (and/or footer): links to the docs/SDK index, the spec, and the GitHub repo. Even a single "Docs" link into a per-language landing would close the gap.

Acceptance criteria

  • Homepage offers a visible link into the SDK documentation (not only the spec)
  • A GitHub/repo link is reachable from the homepage
  • Reaching any SDK's docs from / takes one click from a header/footer nav

Metadata

Metadata

Assignees

No one assigned

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions