Skip to content

docs: add Polish (pl-pl) localization for app and CLI - #168

Draft
Azkel wants to merge 10 commits into
github-samples:mainfrom
Azkel:docs/pl-pl-localization
Draft

Azkel wants to merge 10 commits into
github-samples:mainfrom
Azkel:docs/pl-pl-localization

Conversation

@Azkel

@Azkel Azkel commented Sep 14, 2026 •

Copy link
Copy Markdown

Summary

Adds Polish (pl-pl) localization for the GitHub Copilot App and Copilot CLI workshops, including locale landing pages, localization rules for translators/evaluators, and Starlight wiring so Polish appears in the language selector.

Type of change

  • Workshop content (lesson Markdown, images)
  • Site shell (website/ Astro + Starlight wrapper)
  • Copilot configuration (.github/copilot-instructions.md, instructions, agents, skills)
  • Repo housekeeping (CI, dependabot, README, license)
  • Other:

Verification

  • cd website && rm -rf dist && npm run build succeeds (target: 36 routes × 7 locales + 1 redirect = 253 built pages excluding 404; build reports 254 HTML files including 404, or note any intentional change)
  • Lychee link check passes:
    mkdir -p /tmp/lychee-root && ln -sfn $PWD/website/dist /tmp/lychee-root/copilot-workshops && lychee --offline --no-progress --root-dir /tmp/lychee-root 'website/dist/**/*.html'
  • External GitHub URLs that I changed have been clicked manually (lychee runs offline)

Notes for reviewers

  • Scope: docs/pl-pl/app/** and docs/pl-pl/cli/** only (same harness coverage pattern as other locales). VS Code and Cloud agent English sources are unchanged.
  • Locale wiring: registers pl-pl in website/astro.config.mjs and updates README / AUTHORING / PR-template / build-skill page-count invariants from 6 → 7 locales (253 / 254 HTML files).
  • Rules: new .github/skills/localizations/rules/pl-pl.md documents terminology (e.g. Lekcja in app vs Ćwiczenie in CLI, skill not umiejętność, pull request kept in English, środowisko for harness).
  • Voice: consistent second-person singular (ty) with masculine forms conventional in Polish technical docs (zainstalowałeś, Powinieneś); product UI chrome and learner paste prompts stay English.
  • Verification notes: local build reported 254 HTML files; lychee offline reported 0 errors (16731 total / 13225 OK / 3506 excluded). All 14 external github.com URLs introduced in the Polish docs returned HTTP 200 (same targets as the English sources). https://github.com/copilot/agents redirects to login when unauthenticated, which matches the English lesson behavior.

Completes the pl-pl localization tree for review alongside the earlier base rules and prerequisites.
Incorporate simplified authoring/verification guidance from upstream while keeping Polish localization content and locale configuration.
Incorporate Foundry lesson restructuring and renumber Polish review lessons to 9, keeping pl-pl in locale listings.
@Azkel
Azkel marked this pull request as draft September 20, 2026 20:10
@GeekTrainer

Copy link
Copy Markdown
Collaborator

Thanks so much for putting together the Polish translations, and for the care you've put into reviewing them!

We've just merged a fairly substantial restructure of the workshops, splitting the content into First steps and Real-world development, along with updates to the App and CLI lesson flows. Unfortunately, that means most of the paths and lessons have changed since you started this PR.

I'd love to preserve your contribution and get it aligned with the updated content. I'm happy to work with AI to help adapt the translations if that would be helpful. Thanks again for helping make these workshops available to more people!

@Azkel

Azkel commented Sep 29, 2026 via email

Copy link
Copy Markdown
Author

Azkel added 2 commits October 4, 2026 15:39
Align Polish localization with the First steps / Real-world development split and the refreshed App and CLI lesson flows from upstream.
Add Polish localizations for the Copilot app, CLI, and VS Code First steps paths and point the locale landing at the new pages.

This branch has not been deployed

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

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants