Skip to content

Kotlin API reference pages render breadcrumb with a leading // #15

@nficano

Description

@nficano

Summary

Every Kotlin API reference page (Dokka-generated, synced into content/kotlin/api/**) opens with a breadcrumb that begins with a stray double slash — e.g. //arcp/dev.arcp.auth/BearerAuth. The leading // comes from Dokka's [root]//<package>/<symbol> path convention surviving the markdown sync. The breadcrumb links themselves work; only the leading slashes are wrong. This affects the largest doc tree on the site (~1,000 Kotlin API pages).

Location(s)

  • /kotlin/api/** (site-wide across the Kotlin API reference; ~1,000 pages)
  • Example: /kotlin/api/arcp/dev.arcp.auth/bearer-auth
  • All breakpoints

Severity

P3 — cosmetic nit, but it's the first line of content on every Kotlin API page.

Evidence

Rendered breadcrumb (DOM, /kotlin/api/arcp/dev.arcp.auth/bearer-auth):

//arcp/dev.arcp.auth/BearerAuth

Screenshot: .audit/evidence/audit-kotlin-breadcrumb-leading-slashes-1280.png — top-of-page breadcrumb shows // arcp / dev.arcp.auth / BearerAuth.

Suggested fix

Strip the leading [root]/ / leading slashes from the breadcrumb during the Dokka→markdown sync in scripts/sync-docs.mjs (normalize //pkg/...pkg / ...), or render the breadcrumb from the route segments rather than the raw Dokka path.

Acceptance criteria

  • Kotlin API breadcrumbs start with the package/symbol, not //
  • Breadcrumb links continue to resolve to the correct lowercase routes

Metadata

Metadata

Assignees

No one assigned

    Labels

    bugSomething isn't workingdocsp3ui

    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