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

.github/copilot-instructions.md

@@ -10,7 +10,7 @@ This repo hosts the **workshop content** for **Copilot Workshops**, published as
   - `README.md` — Workshop landing page (also the site home via `slug: index` frontmatter).
   - `first-steps/` — Guided introductory workshops (`copilot-app/`, `copilot-cli/`, and `vscode/`). Each workshop has its own folder and `README.md` landing page.
   - `real-world-development/` — Scenario-based workshops organized by environment (`cli/`, `vscode/`, `cloud/`, and `app/`). Each environment's landing page is a `README.md` routed via a slug matching the full category path. Each workshop opens with its own `0-prerequisites.md` setup lesson.
-  - `es-es/`, `ja-jp/`, `ko-kr/`, `pt-br/`, `zh-cn/` — Localized content at the locale-root paths required by Starlight. Translated pages mirror the English path beneath each locale directory; untranslated pages use Starlight's English fallback.
+  - `es-es/`, `ja-jp/`, `ko-kr/`, `pl-pl/`, `pt-br/`, `zh-cn/` — Localized content at the locale-root paths required by Starlight. Translated pages mirror the English path beneath each locale directory; untranslated pages use Starlight's English fallback.
   - `_images/` — Screenshots and diagrams (shared across all locales).
 - `website/` — Optional Astro + Starlight site that publishes `docs/` to GitHub Pages (loader `base: '../docs'`). Only needed to self-host or preview the rendered site.
   - `astro.config.mjs` — Site config including the manually maintained sidebar and the `locales` block. The legacy `/shared/0-prereqs/` → home (`/`) redirect is a full-HTML redirect page at `src/pages/shared/0-prereqs.astro` (not an `astro.config.mjs` `redirects` entry, which would emit a stub with no `<html>` element that Pagefind can't index). Prerequisites are now per workshop (`/<category>/<workshop>/0-prerequisites/`), so the old shared-prereqs URL forwards to the home page.

AUTHORING.md

@@ -21,7 +21,7 @@ copilot-workshops/
 │   │   ├── vscode/              ← VS Code lessons, including the optional 7-foundry-toolkit/ series
 │   │   ├── cloud/               ← Cloud agent lessons
 │   │   └── app/                 ← GitHub Copilot app lessons
-│   ├── es-es/ ja-jp/ ...        ← Translated locale trees mirroring source paths
+│   ├── es-es/ ja-jp/ ko-kr/ pl-pl/ pt-br/ zh-cn/  ← Translated locale trees mirroring source paths
 │   └── _images/                 ← Screenshots and diagrams (shared across locales)
 ├── website/                     ← Optional Astro + Starlight publisher
 │   ├── astro.config.mjs         ← Site URL, base path, locales, sidebar

README.md

@@ -23,7 +23,7 @@ For PR/CI rules, see **[CONTRIBUTING.md](./CONTRIBUTING.md)**.
   - `README.md` — Workshop landing page (also the published site's home via `slug: index`).
   - `first-steps/` — Guided introductory workshops for the GitHub Copilot app, GitHub Copilot CLI, and VS Code, adapted from James Montemagno's [First Steps with GitHub Copilot](https://github.com/jamesmontemagno/first-steps-with-github-copilot) (MIT).
   - `real-world-development/` — Scenario-based workshops organized by environment: `cli/`, `vscode/`, `cloud/`, and `app/`.
-  - `es-es/`, `ja-jp/`, `ko-kr/`, `pt-br/`, `zh-cn/` — Translated locale trees that mirror available English category and workshop paths.
+  - `es-es/`, `ja-jp/`, `ko-kr/`, `pl-pl/`, `pt-br/`, `zh-cn/` — Translated locale trees that mirror available English category and workshop paths.
   - `_images/` — Screenshots and diagrams (shared across all locales).
 - **`website/`** — Optional Astro + Starlight site that publishes `docs/` to GitHub Pages. Only needed to self-host or preview the rendered site.
   - `astro.config.mjs` — Site URL, base path, `locales` block, sidebar.

docs/pl-pl/README.md

@@ -0,0 +1,44 @@
+---
+slug: pl-pl
+title: "Warsztaty GitHub Copilot"
+authors:
+  - geektrainer
+  - azkel
+lastUpdated: 2026-10-04
+---
+
+Wybierz warsztat w zależności od tego, czego chcesz się nauczyć i jak głęboko chcesz to poznać. **Pierwsze kroki** to prowadzone wprowadzenie do GitHub Copilot, a **Rozwój w realnych scenariuszach** korzysta z pełnej aplikacji i backlogu zespołu, aby ćwiczyć przepływy pracy zbliżone do produkcyjnych.
+
+## Pierwsze kroki
+
+Zacznij od skoncentrowanego, prowadzonego doświadczenia, które przedstawia kluczowe możliwości produktu GitHub Copilot bez wymagania istniejącej bazy kodu.
+
+### [Przewodnik po aplikacji GitHub Copilot][first-steps-app]
+
+Zbuduj Space Quiz z pustego folderu, opublikuj go na GitHubie, zaimplementuj zgłoszenie, ukończ przegląd Copilota, zaplanuj automatyzację i poznaj przepływ pracy z kanwą (Canvas).
+
+### [Pierwsze kroki z GitHub Copilot CLI][first-steps-cli]
+
+Zbuduj ten sam Space Quiz w terminalu, przeglądaj diffy, uruchamiaj równoległe sesje w worktree, planuj przed edycją oraz twórz, scalaj i deleguj pull requesty bez opuszczania powłoki.
+
+### [Pierwsze kroki z Visual Studio Code][first-steps-vscode]
+
+Zbuduj Space Quiz w VS Code, przetestuj go w zintegrowanej przeglądarce, opublikuj przez Source Control, pracuj ze zgłoszeniami i pull requestami przez narzędzia GitHub oraz przekaż pracę do sesji w chmurze.
+
+## Rozwój w realnych scenariuszach
+
+Ćwicz GitHub Copilot w realistycznym cyklu życia oprogramowania, korzystając z aplikacji Tailspin Toys i jej backlogu. Wybierz środowisko, w którym chcesz pracować, a następnie planuj, buduj, testuj, przeglądaj i dostarczaj istotne zmiany.
+
+### [Przeglądaj warsztaty rozwoju w realnych scenariuszach][real-world-development]
+
+Wybierz spośród GitHub Copilot CLI, aplikacji GitHub Copilot, agenta chmurowego GitHub Copilot lub Visual Studio Code.
+
+> [!CAUTION]
+> GitHub Copilot jest probabilistyczny, a nie deterministyczny, więc dokładny kod i zmienione pliki mogą się różnić od przykładów. Drobne różnice są oczekiwane.
+>
+> Jeśli coś wygląda na uszkodzone lub nie działa poprawnie podczas warsztatów prowadzonych przez instruktora, poproś mentora o pomoc.
+
+[first-steps-app]: first-steps/copilot-app/
+[first-steps-cli]: first-steps/copilot-cli/
+[first-steps-vscode]: first-steps/vscode/
+[real-world-development]: real-world-development/

docs/pl-pl/first-steps/README.md

@@ -0,0 +1,36 @@
+---
+title: "Pierwsze kroki"
+slug: pl-pl/first-steps
+authors:
+  - geektrainer
+  - azkel
+lastUpdated: 2026-10-04
+---
+
+Warsztaty Pierwsze kroki to prowadzone wprowadzenia, które pomagają poznać GitHub Copilot bez wymagania istniejącej aplikacji ani szczegółowego scenariusza rozwojowego. Każdy warsztat zaczyna się od małych kroków, przedstawia produkt w trakcie używania i przeprowadza Cię przez kompletny przepływ pracy.
+
+Każdy warsztat buduje ten sam Space Quiz z pustego folderu, więc możesz wybrać narzędzie, którego chcesz się nauczyć, albo ukończyć więcej niż jedno, aby porównać, jak każde z nich działa.
+
+> [!NOTE]
+> Te warsztaty stworzył [James Montemagno][james], a zostały zaadaptowane z [First Steps with GitHub Copilot][source-lab], dostępnego na licencji [MIT][source-license].
+
+## Warsztaty
+
+### [Przewodnik po aplikacji GitHub Copilot][copilot-app]
+
+Zbuduj kolorowy Space Quiz z pustego folderu i przejdź przez pętlę rozwoju: utwórz, dopracuj, przetestuj, zapisz instrukcje projektu, opublikuj, zaplanuj pracę, zaimplementuj zgłoszenia, przejrzyj i scal pull request, zautomatyzuj powtarzalną pracę oraz poznaj rozszerzenie Canvas.
+
+### [Pierwsze kroki z GitHub Copilot CLI][copilot-cli]
+
+Poznaj pętlę terminalową: buduj i przeglądaj diffy zanim Git cokolwiek zapisze, uruchamiaj sesje równolegle w worktree, planuj przed edycją, zarządzaj kontekstem, a następnie twórz, scalaj i deleguj pracę bez opuszczania powłoki.
+
+### [Pierwsze kroki z Visual Studio Code][vscode]
+
+Użyj pętli edytora: buduj w obszarze roboczym, dopracowuj elementy z zintegrowanej przeglądarki, sprawdzaj kontekst, testuj zanim Git cokolwiek zapisze, planuj przed edycją i pozwól narzędziom GitHub obsłużyć zgłoszenia, pull requesty oraz sesje w chmurze bez opuszczania VS Code.
+
+[james]: https://github.com/jamesmontemagno
+[source-lab]: https://github.com/jamesmontemagno/first-steps-with-github-copilot
+[source-license]: https://github.com/jamesmontemagno/first-steps-with-github-copilot/blob/main/LICENSE
+[copilot-app]: copilot-app/
+[copilot-cli]: copilot-cli/
+[vscode]: vscode/

docs/pl-pl/first-steps/copilot-app/0-prerequisites.md

@@ -0,0 +1,75 @@
+---
+title: "Lekcja 0 - Wymagania wstępne i konfiguracja"
+description: "Sprawdź wymagania wstępne warsztatu, zainstaluj aplikację GitHub Copilot i poznaj jej obszar roboczy."
+authors:
+  - jamesmontemagno
+  - azkel
+lastUpdated: 2026-09-28
+---
+
+Zanim zbudujesz Space Quiz, upewnij się, że masz wszystko, czego potrzebujesz, zainstaluj aplikację GitHub Copilot i poznaj jej obszar roboczy.
+
+W tej lekcji:
+
+- sprawdzisz wymagania wstępne warsztatu.
+- zainstalujesz aplikację GitHub Copilot i zalogujesz się.
+- wybierzesz model do sesji.
+- poznasz główne obszary pracy aplikacji.
+- wypróbujesz szybki czat.
+
+## Wymagania wstępne
+
+Potrzebujesz:
+
+- konta GitHub z [planem Copilot][copilot-plans].
+- komputera z systemem macOS, Windows lub Linux.
+
+Aplikacja zawiera Git, więc nie musisz instalować nic więcej.
+
+> [!NOTE]
+> Jeśli korzystasz z Copilot Business lub Copilot Enterprise, administrator musi włączyć zasadę **Copilot CLI**, zanim sesje agenta zaczną działać.
+
+## Zainstaluj i skonfiguruj aplikację
+
+1. Pobierz i zainstaluj [aplikację GitHub Copilot][download-app] dla swojego systemu operacyjnego.
+2. Otwórz aplikację.
+3. Wybierz **Sign in to GitHub** i uwierzytelnij się.
+4. Wybierz motyw, a następnie **Finish**.
+
+## Wybierz model
+
+Przy wyborze modelu stosuj poniższą kolejność preferencji i wybierz pierwszą dostępną opcję:
+
+1. **GPT-6-Luna** (zalecany).
+2. **Auto**, jako zrównoważona opcja zapasowa.
+3. Dowolny model z [listy aktywnych modeli][active-models].
+
+Dostępność modeli zależy od planu, zasad organizacji i wersji produktu.
+
+## Poznaj obszar roboczy
+
+Aplikacja łączy przepływ pracy rozwojowej w jednym miejscu:
+
+- **New**: Uruchom sesję w projekcie albo wybierz **Chat**, aby zadać szybkie pytanie.
+- **My work**: Przeglądaj zgłoszenia i pull requesty na GitHubie.
+- **Automations**: Planuj powtarzalną pracę agenta w repozytorium.
+- **Customize**: Zmieniaj motywy i modele oraz zarządzaj rozszerzeniami kanw.
+
+## Wypróbuj szybki czat
+
+Nie każde pytanie wymaga obszaru roboczego. W **New** wybierz **Chat** zamiast projektu. Czat nie ma podłączonego repozytorium i nie może edytować plików, więc to najszybszy sposób, by zadać pytanie, uzyskać wyjaśnienie albo przemyśleć podejście przed prawdziwą sesją.
+
+Wyślij poniższe polecenie w czacie:
+
+```plaintext
+How does the GitHub Copilot app use worktrees?
+```
+
+## Podsumowanie i kolejne kroki
+
+Sprawdziłeś wymagania wstępne, zainstalowałeś aplikację, wybrałeś model i poznałeś jej główne obszary pracy. Przejdź do [Lekcji 1: Utwórz obszar roboczy Space Quiz][next-lesson].
+
+[copilot-plans]: https://github.com/features/copilot/plans
+[download-app]: https://gh.io/app
+[active-models]: https://docs.github.com/copilot/reference/copilot-billing/models-and-pricing
+[next-lesson]: ../1-create-workspace/

docs/pl-pl/first-steps/copilot-app/1-create-workspace.md

@@ -0,0 +1,35 @@
+---
+title: "Lekcja 1 - Utwórz obszar roboczy Space Quiz"
+description: "Uruchom lokalną sesję Interactive dla Space Quiz w pustym folderze."
+authors:
+  - jamesmontemagno
+  - azkel
+lastUpdated: 2026-09-28
+---
+
+Utwórz lokalny obszar roboczy dla Space Quiz i skonfiguruj sesję, w której zachowasz kontrolę, gdy agent zacznie pracę.
+
+W tej lekcji:
+
+- otworzysz pusty folder lokalny.
+- uruchomisz sesję agenta w trybie Interactive.
+- potwierdzisz folder, tryb i model przed pierwszym promptem.
+
+## Utwórz obszar roboczy
+
+1. Otwórz aplikację GitHub Copilot i upewnij się, że jesteś zalogowany.
+2. Wybierz **New**, potem **Open folder**, i wskaż pusty folder o nazwie `space-quiz`. Najpierw utwórz folder, jeśli jeszcze nie istnieje.
+3. Ustaw tryb sesji na **Interactive**.
+4. Wybierz preferowany model według [kolejności preferencji z Lekcji 0][model-order].
+5. Wybierz **Create**. Sesja otworzy się pusta i będzie czekać na pierwsze polecenie.
+
+![Ilustracja ekranu New w aplikacji Copilot z polem promptu, trybem Interactive, modelem Auto i wyborem agenta Default oraz folderem space-quiz na lokalnej gałęzi main.](../../../_images/first-steps-app-new-session.svg)
+
+Ekran **New** to miejsce, w którym ustawiasz folder, tryb i agenta, zanim wpiszesz pierwsze polecenie. Sesja Interactive pozwala kierować pracą i przeglądać każdy etap, podczas gdy agent buduje projekt.
+
+## Podsumowanie i kolejne kroki
+
+Pusty obszar roboczy Space Quiz jest gotowy. Przejdź do [Lekcji 2: Zbuduj i dopracuj quiz][next-lesson].
+
+[model-order]: ../0-prerequisites/#wybierz-model
+[next-lesson]: ../2-build-and-polish/

docs/pl-pl/first-steps/copilot-app/10-remote.md

@@ -0,0 +1,34 @@
+---
+title: "Lekcja 10 - Kontynuuj sesję zdalnie (opcjonalnie)"
+description: "Użyj /remote, aby kontynuować trwającą sesję aplikacji na GitHubie i śledzić ją z dowolnego urządzenia."
+authors:
+  - jamesmontemagno
+  - azkel
+lastUpdated: 2026-09-28
+---
+
+Ta lekcja jest opcjonalna — warto zostawić ją na moment, gdy lokalna pętla będzie już naturalna. Polecenie `/remote` kontynuuje sesję, w której już jesteś, na GitHubie, dzięki czemu możesz odejść od komputera i nadal ją śledzić.
+
+W tej lekcji:
+
+- kontynuujesz trwającą sesję zdalnie.
+- śledzisz zdalną sesję z przeglądarki.
+- przejrzysz wynikające zmiany tak samo jak każdy inny pull request.
+
+## Kontynuuj sesję zdalnie
+
+1. Otwórz sesję, w której trwa praca.
+2. Uruchom `/remote`, aby kontynuować tę sesję zdalnie.
+3. Wybierz zwrócony link, aby otworzyć zdalną sesję w przeglądarce.
+4. Śledź postęp stamtąd, a następnie przejrzyj zmiany dokładnie tak, jak przy każdym innym pull requeście.
+
+> [!NOTE]
+> **To nie jest delegacja**
+>
+> Nie przekazujesz zadania innemu agentowi. To ta sama sesja, kontynuowana w miejscu, do którego dotrzesz z dowolnego urządzenia.
+
+## Podsumowanie i kolejne kroki
+
+Kontynuowałeś sesję poza lokalną maszyną. Przejdź do [Lekcji 11: Poznaj kanwę][next-lesson].
+
+[next-lesson]: ../11-canvas/

docs/pl-pl/first-steps/copilot-app/11-canvas.md

@@ -0,0 +1,51 @@
+---
+title: "Lekcja 11 - Poznaj kanwę"
+description: "Zainstaluj kanwę Repository Issues Kanban i uruchom sesję z karty zgłoszenia."
+authors:
+  - jamesmontemagno
+  - azkel
+lastUpdated: 2026-09-28
+---
+
+**Kanwa (Canvas)** to współdzielona, dwukierunkowa powierzchnia, na której Ty i agent możecie aktualizować ten sam plan, tablicę, listę kontrolną albo pulpit. Poznaj kanwę Kanban, która zamienia zgłoszenia repozytorium w wizualny przepływ pracy.
+
+W tej lekcji:
+
+- zainstalujesz rozszerzenie kanwy.
+- połączysz kanwę z repozytorium Space Quiz.
+- przeniesiesz zgłoszenie do aktywnej pracy.
+- przejrzysz sesję utworzoną na podstawie zgłoszenia.
+
+## Zainstaluj kanwę Repository Issues Kanban
+
+1. Przejrzyj [galerię rozszerzeń Canvas][canvas-gallery].
+2. Otwórz [rozszerzenie Repository Issues Kanban][kanban-extension].
+3. Wybierz **Install in GitHub Copilot app** i zatwierdź instalację.
+4. W aplikacji otwórz **Customize**, a następnie **Canvas**.
+5. Upewnij się, że rozszerzenie jest zainstalowane.
+
+## Zacznij pracę z kanwy
+
+1. Wybierz **New session** dla kanwy.
+2. Wybierz projekt `space-quiz`.
+3. Poznaj tablicę zgłoszeń.
+4. Przenieś kartę zgłoszenia do kolumny aktywnej pracy.
+5. Otwórz automatycznie wygenerowaną sesję.
+6. Upewnij się, że wybrane zgłoszenie jest dostępne jako kontekst sesji.
+
+![Ilustracja kanwy Repository Issues Kanban z pasami Backlog, Plan, Ready i Implement. Zgłoszenie 13, Review screen, jest przeciągane z Backlog do pasa Plan, a zgłoszenie 12, Per-question timer, pozostaje w Backlog.](../../../_images/first-steps-app-canvas-kanban.svg)
+
+Gdy upuścisz kartę na pas, kanwa przekazuje to zgłoszenie do nowej sesji z już załadowanym zgłoszeniem.
+
+> [!NOTE]
+> Bieżące rozszerzenie Repository Issues Kanban przenosi karty przez przeciąganie i upuszczanie wskaźnikiem. Jeśli nie możesz użyć tej interakcji, zanotuj numer zgłoszenia na tablicy, otwórz zgłoszenie w **My work**, a następnie wybierz **New session**. To tworzy tę samą sesję opartą na zgłoszeniu bez przenoszenia karty.
+
+Kanwa daje wizualny sposób wyboru i rozpoczęcia pracy, jednocześnie utrzymując agenta w kontekście zgłoszenia.
+
+## Podsumowanie i kolejne kroki
+
+Użyłeś współdzielonej powierzchni wizualnej, aby uruchomić sesję agenta. Przejdź do [Lekcji 12: Podsumowanie i kolejne kroki][next-lesson].
+
+[canvas-gallery]: https://awesome-copilot.github.com/extensions/
+[kanban-extension]: https://awesome-copilot.github.com/extension/accessibility-kanban/
+[next-lesson]: ../12-review/

docs/pl-pl/first-steps/copilot-app/12-review.md

@@ -0,0 +1,52 @@
+---
+title: "Lekcja 12 - Podsumowanie i kolejne kroki"
+description: "Podsumuj przepływ pracy w aplikacji GitHub Copilot i znajdź zasoby do dalszej nauki."
+authors:
+  - jamesmontemagno
+  - azkel
+lastUpdated: 2026-09-28
+---
+
+Kierowałeś agentem przez kompletny przepływ pracy rozwojowej: od pustego folderu przez zaplanowaną pracę, izolowaną implementację, przegląd kodu, automatyzację, sesję zdalną aż po wizualną kanwę.
+
+## Co ukończyłeś
+
+Ukończyłeś:
+
+- utworzenie lokalnego projektu w trybie Interactive.
+- zbudowanie i dopracowanie quizu z żywą informacją zwrotną z przeglądarki.
+- przejrzenie szczegółów sesji i uruchomienie smoke testu na poziomie przeglądarki.
+- zapisanie reguł projektu za pomocą `/init`.
+- opublikowanie projektu jako repozytorium GitHub.
+- utworzenie skupionego backlogu.
+- zaimplementowanie zgłoszenia w izolowanym worktree i przejrzenie diffu.
+- zaplanowanie drugiego zgłoszenia przed jakąkolwiek zmianą w kodzie.
+- przeprowadzenie zgłoszenia przez przegląd pull requesta i Agent Merge.
+- zautomatyzowanie cotygodniowego triage zgłoszeń.
+- kontynuowanie sesji zdalnie.
+- poznanie współdzielonej kanwy Kanban.
+
+## Kontynuuj eksplorację
+
+- [Dowiedz się więcej o aplikacji GitHub Copilot][about-app].
+- [Przejrzyj oficjalny przewodnik rozpoczęcia pracy][getting-started].
+- [Naucz się pracy z sesjami agenta][agent-sessions].
+- [Zarządzaj zgłoszeniami i pull requestami w aplikacji][issues-and-prs].
+- [Dowiedz się więcej o przeglądzie kodu Copilot][code-review].
+- [Buduj i używaj rozszerzeń Canvas][canvas-extensions].
+- [Stosuj dobre praktyki pisania promptów, które sprawdzają się na realnym kodzie][best-practices].
+- [Porównaj plany Copilot][copilot-plans].
+
+Przeprowadź ten sam Space Quiz w innym sposobie pracy w [warsztacie Pierwsze kroki z Copilot CLI][first-steps-cli] albo w [warsztacie Pierwsze kroki z Visual Studio Code][first-steps-vscode]. Jeśli jesteś gotowy na głębszy scenariusz z kompletną aplikacją i backlogiem zespołu, kontynuuj z [warsztatem aplikacji GitHub Copilot w realnym świecie][real-world-app].
+
+[about-app]: https://docs.github.com/copilot/concepts/agents/github-copilot-app
+[getting-started]: https://docs.github.com/copilot/how-tos/github-copilot-app/getting-started
+[agent-sessions]: https://docs.github.com/copilot/how-tos/github-copilot-app/agent-sessions
+[issues-and-prs]: https://docs.github.com/copilot/how-tos/github-copilot-app/managing-issues-and-pull-requests
+[code-review]: https://docs.github.com/copilot/concepts/code-review/code-review
+[canvas-extensions]: https://docs.github.com/copilot/how-tos/github-copilot-app/working-with-canvas-extensions
+[best-practices]: https://docs.github.com/copilot/get-started/best-practices
+[copilot-plans]: https://github.com/features/copilot/plans
+[first-steps-cli]: ../copilot-cli/
+[first-steps-vscode]: ../vscode/
+[real-world-app]: ../../real-world-development/app/