fix(a11y): two navigation landmarks are both called "Bitborg" #157

Stängd
öppnade 2026-08-02 12:30:09 +00:00 av supernaut · 0 kommentarer
Ägare

Every page exposes these navigation landmarks:

Sekundär navigering · Byt språk · Navigering · Bitborg · Bitborg · Legal

Two of them share a name:

  • src/components/main-navigation.astro:95 uses nav.app.label (src/i18n/ui.ts:71 / :343) =
    "Bitborg" — the "Open Bitborg" external link.
  • src/components/footer.astro:106 uses nav.service.label (src/i18n/ui.ts:83 / :355) =
    "Bitborg" — the footer service column.

A screen reader's landmark list offers "Bitborg navigation" twice with no way to tell them apart
(WCAG 1.3.1). src/pages/404.astro:32-34 already documents this exact rule and follows it there.

Two smaller problems in the same strings:

  • nav.main.label ("Main Navigation" / "Navigering") and nav.secondary.label ("Secondary
    Navigation" / "Sekundär navigering") repeat the role — announced as "Main Navigation navigation".
  • nav.legal.label is the string "Legal" in both dictionaries (src/i18n/ui.ts:75 and :347)
    and renders as visible Swedish copy in the footer (src/components/footer.astro:122).

Fix

src/i18n/ui.ts only, both dictionaries. docs/content-style.md § "Product & feature terms" says
the git application is just "Bitborg", with the hostname added only where the website and the
application must be told apart — which is this case.

Key Now (en / sv) Proposed (en / sv)
nav.app.label Bitborg / Bitborg Bitborg at git.gitborg.se / Bitborg på git.gitborg.se
nav.main.label Main Navigation / Navigering Pages / Sidor
nav.secondary.label Secondary Navigation / Sekundär navigering Account / Konto
nav.legal.label Legal / Legal Legal / Villkor

nav.service.label stays "Bitborg" — it is a visible footer heading, and the pair is unique once
nav.app.label changes.

Done when

  • No two navigation landmarks on any page share an accessible name.
  • No landmark name contains "navigation" or "navigering".
  • pnpm lang-check passes and the copy has been checked against docs/content-style.md.

Part of gitborg/gitborg-docs#67.

Every page exposes these navigation landmarks: Sekundär navigering · Byt språk · Navigering · Bitborg · Bitborg · Legal Two of them share a name: - `src/components/main-navigation.astro:95` uses `nav.app.label` (`src/i18n/ui.ts:71` / `:343`) = "Bitborg" — the "Open Bitborg" external link. - `src/components/footer.astro:106` uses `nav.service.label` (`src/i18n/ui.ts:83` / `:355`) = "Bitborg" — the footer service column. A screen reader's landmark list offers "Bitborg navigation" twice with no way to tell them apart (WCAG 1.3.1). `src/pages/404.astro:32-34` already documents this exact rule and follows it there. Two smaller problems in the same strings: - `nav.main.label` ("Main Navigation" / "Navigering") and `nav.secondary.label` ("Secondary Navigation" / "Sekundär navigering") repeat the role — announced as "Main Navigation navigation". - `nav.legal.label` is the string "Legal" in **both** dictionaries (`src/i18n/ui.ts:75` and `:347`) and renders as visible Swedish copy in the footer (`src/components/footer.astro:122`). ## Fix `src/i18n/ui.ts` only, both dictionaries. `docs/content-style.md` § "Product & feature terms" says the git application is just "Bitborg", with the hostname added only where the website and the application must be told apart — which is this case. | Key | Now (en / sv) | Proposed (en / sv) | | --- | --- | --- | | `nav.app.label` | Bitborg / Bitborg | Bitborg at git.gitborg.se / Bitborg på git.gitborg.se | | `nav.main.label` | Main Navigation / Navigering | Pages / Sidor | | `nav.secondary.label` | Secondary Navigation / Sekundär navigering | Account / Konto | | `nav.legal.label` | Legal / Legal | Legal / Villkor | `nav.service.label` stays "Bitborg" — it is a visible footer heading, and the pair is unique once `nav.app.label` changes. ## Done when - No two navigation landmarks on any page share an accessible name. - No landmark name contains "navigation" or "navigering". - `pnpm lang-check` passes and the copy has been checked against `docs/content-style.md`. Part of gitborg/gitborg-docs#67.
supernaut lade till detta till projektet Bitborg Web 2026-08-02 12:34:24 +00:00
supernaut ändrade titeln från fix(a11y): two navigation landmarks are both called "Gitborg" till fix(a11y): two navigation landmarks are both called "Bitborg" 2026-08-03 09:58:55 +00:00
Logga in för att delta i denna konversation.
Ingen milstolpe
Inget projekt
Inga tilldelade
1 deltagare
Notiser
Förfallodatum
Förfallodatumet är ogiltigt eller utanför gränserna. Använd formatet "åååå-mm-dd".

Inget förfallodatum satt.

Beroenden

Inga beroenden satta

Referens
bitborg/bitborg-web#157
Ingen beskrivning angiven.