Skip to content

French docs sidebar shows English section labels #1793

Open

Description

@joshunrau

On the French docs pages, the sidebar's section headings are in English: "Tutorials", "Reference", "Changelog" and "Runtime Core API". The sidebar groups in astro.config.ts set only label, with no translations, so Starlight shows the same string in every locale. The French home page names the same sections "Tutoriels" and "Référence", and every other piece of Starlight chrome on those pages is French ("Sur cette page", "Suivant"). A French reader sees the page call the section "Référence" while the sidebar beside it says "Reference". (The pages inside these sections are English-only by design, docs/AGENTS.md; this concerns only the navigation labels.)

Where

apps/outreach/astro.config.ts:79-102 (excerpt):

{
  autogenerate: { directory: 'docs/2-tutorials' },
  label: 'Tutorials'
},
...
{
  autogenerate: { directory: 'docs/5-reference' },
  label: 'Reference'
},
{
  label: 'Changelog',
  slug: 'docs/changelog'
},

and :71-74, the typedoc group:

sidebar: {
  collapsed: true,
  label: 'Runtime Core API'
},

docs/fr/1-introduction/1.0-home.md names them "Tutoriels (en anglais)" and "Référence (en anglais)".

Reproduce

  1. Open https://opendatacapture.org/fr/docs/introduction/home/.
  2. Read the sidebar group headings.

Actual: "Introduction, Tutorials, Guides, Concepts, Reference, Changelog, Runtime Core API".
Expected: "Introduction, Tutoriels, Guides, Concepts, Référence, Journal des modifications, API de Runtime Core", matching the French home page.

Tests

apps/outreach has no unit or Playwright suite, by decision (apps/outreach/AGENTS.md). Verify through the build: the sidebar in dist/fr/docs/introduction/home/index.html shows the French labels, and the English pages are unchanged.

Suggested fix

Add translations: { fr: '…' } to the Tutorials, Reference and Changelog sidebar entries, which Starlight supports on both groups and links. For the typedoc group, add a translations field to StarlightTypeDocSidebarOptions and pass it through in getSidebarGroupFromPackageReflections/getSidebarGroupFromReflections.

Activity

  1. added
    BugType: existing behavior is wrong
    Priority: LowNice to have, cosmetic or speculative
    Difficulty: LowIsolated change, about 2 hours or less
    Area: Outreachapps/outreach and docs/ (marketing site and user documentation)
    Good First IssueWell-scoped, low-risk and self-contained; a good entry point for a new contributor
    on Oct 7, 2026
  2. Shaji-Mohammed commented on Oct 14, 2026

    @Shaji-Mohammed

    I’d like to work on this issue. I’ll add the French sidebar translations and verify the documentation build. Please let me know if anyone is already working on it.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    Area: Outreachapps/outreach and docs/ (marketing site and user documentation)BugType: existing behavior is wrongDifficulty: LowIsolated change, about 2 hours or lessGood First IssueWell-scoped, low-risk and self-contained; a good entry point for a new contributorPriority: LowNice to have, cosmetic or speculative

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions