docs: restructure Foundry lessons to match workshop patterns (Copilot app harness) - #181
Open
GeekTrainer wants to merge 2 commits into
Open
GeekTrainer wants to merge 2 commits into
GeekTrainer wants to merge 2 commits into
Conversation
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
GeekTrainer
added this pull request to stack #182
September 16, 2026 17:34
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
juliamuiruri4
approved these changes
Sep 17, 2026
juliamuiruri4
left a comment
juliamuiruri4
left a comment
Collaborator
There was a problem hiding this comment.
Minor tweaks to improve flow and remove duplicate messaging. This looks great!
Contributor
There was a problem hiding this comment.
Copilot review overview
🟡 Changes recommended
The six final site-integration modules omit the Create PR/Agent Merge handoff.
Get a fresh assessment by requesting another Copilot review.
Review effort: Lite
Findings: 6
Open (6)
What changed in this PR
Restructures the optional Copilot app Foundry workshop into an overview and three guided lessons across English and five locales.
Changes:
- Splits setup, deployment, and site integration into separate modules.
- Updates navigation, review links, and localized content.
- Documents nested optional-module authoring.
| File | Summary |
|---|---|
website/astro.config.mjs |
Registers the localized optional Foundry sidebar. |
docs/zh-cn/app/README.md |
Updates the Chinese app overview. |
docs/zh-cn/app/9-review.md |
Updates Chinese review navigation. |
docs/zh-cn/app/8-foundry-canvas/README.md |
Adds the Chinese Foundry overview. |
docs/zh-cn/app/8-foundry-canvas/3-connect-to-site.md |
Adds Chinese integration guidance. Nit (3 votes): restore or link the final Create PR/Agent Merge handoff. |
docs/zh-cn/app/8-foundry-canvas/2-build-and-deploy.md |
Adds Chinese deployment guidance. |
docs/zh-cn/app/8-foundry-canvas/1-project-and-model.md |
Adds Chinese setup guidance. |
docs/zh-cn/app/7-canvases.md |
Updates Chinese core and optional navigation. |
docs/pt-br/app/README.md |
Updates the Portuguese app overview. |
docs/pt-br/app/9-review.md |
Updates Portuguese review navigation. |
docs/pt-br/app/8-foundry-canvas/README.md |
Adds the Portuguese Foundry overview. |
docs/pt-br/app/8-foundry-canvas/3-connect-to-site.md |
Adds Portuguese integration guidance. Nit (3 votes): restore or link the final Create PR/Agent Merge handoff. |
docs/pt-br/app/8-foundry-canvas/2-build-and-deploy.md |
Adds Portuguese deployment guidance. |
docs/pt-br/app/8-foundry-canvas/1-project-and-model.md |
Adds Portuguese setup guidance. |
docs/pt-br/app/7-canvases.md |
Updates Portuguese core and optional navigation. |
docs/ko-kr/app/README.md |
Updates the Korean app overview. |
docs/ko-kr/app/9-review.md |
Updates Korean review navigation. |
docs/ko-kr/app/8-foundry-canvas/README.md |
Adds the Korean Foundry overview. |
docs/ko-kr/app/8-foundry-canvas/3-connect-to-site.md |
Adds Korean integration guidance. Nit (3 votes): restore or link the final Create PR/Agent Merge handoff. |
docs/ko-kr/app/8-foundry-canvas/2-build-and-deploy.md |
Adds Korean deployment guidance. |
docs/ko-kr/app/8-foundry-canvas/1-project-and-model.md |
Adds Korean setup guidance. |
docs/ko-kr/app/7-canvases.md |
Updates Korean core and optional navigation. |
docs/ja-jp/app/README.md |
Updates the Japanese app overview. |
docs/ja-jp/app/9-review.md |
Updates Japanese review navigation. |
docs/ja-jp/app/8-foundry-canvas/README.md |
Adds the Japanese Foundry overview. |
docs/ja-jp/app/8-foundry-canvas/3-connect-to-site.md |
Adds Japanese integration guidance. Nit (3 votes): restore or link the final Create PR/Agent Merge handoff. |
docs/ja-jp/app/8-foundry-canvas/2-build-and-deploy.md |
Adds Japanese deployment guidance. |
docs/ja-jp/app/8-foundry-canvas/1-project-and-model.md |
Adds Japanese setup guidance. |
docs/ja-jp/app/7-canvases.md |
Updates Japanese core and optional navigation. |
docs/es-es/app/README.md |
Updates the Spanish app overview. |
docs/es-es/app/9-review.md |
Updates Spanish review navigation. |
docs/es-es/app/8-foundry-canvas/README.md |
Adds the Spanish Foundry overview. |
docs/es-es/app/8-foundry-canvas/3-connect-to-site.md |
Adds Spanish integration guidance. Nit (3 votes): restore or link the final Create PR/Agent Merge handoff. |
docs/es-es/app/8-foundry-canvas/2-build-and-deploy.md |
Adds Spanish deployment guidance. |
docs/es-es/app/8-foundry-canvas/1-project-and-model.md |
Adds Spanish setup guidance. |
docs/es-es/app/7-canvases.md |
Updates Spanish core and optional navigation. |
docs/app/README.md |
Updates the English app overview. |
docs/app/9-review.md |
Updates English review navigation. |
docs/app/8-foundry-canvas/README.md |
Adds the Foundry overview. |
docs/app/8-foundry-canvas/3-connect-to-site.md |
Adds integration guidance. Nit (3 votes): restore or link the final Create PR/Agent Merge handoff. |
docs/app/8-foundry-canvas/2-build-and-deploy.md |
Adds deployment guidance. |
docs/app/8-foundry-canvas/1-project-and-model.md |
Adds setup guidance. |
docs/app/8-foundry-canvas.md |
Removes the former monolithic lesson. |
docs/app/7-canvases.md |
Updates English core and optional navigation. |
AUTHORING.md |
Documents nested optional-module authoring. |
💡 Configure MCP servers for context-aware, tailored reviews. Learn more in the docs.
|
|
||
| You built a local credential-safe proxy, connected an accessible chat widget, and verified the full conversation flow against the hosted Backer Concierge. The checkpoint for this module is a locally tested website integration that preserves the catalog boundary and keeps credentials and internal Foundry identifiers out of the browser. It is not a production deployment of the proxy or site. | ||
|
|
||
| When you're finished experimenting, stop both local services and [clean up your Azure resources][cleanup]. Then continue to [Review and next steps][core-review] on the core workshop route. |
|
|
||
| Has creado un proxy local que protege las credenciales, conectado un widget de chat accesible y verificado el flujo completo de la conversación con el Backer Concierge hospedado. El punto de control de este módulo es una integración del sitio web probada en local que conserva los límites del catálogo y mantiene las credenciales y los identificadores internos de Foundry fuera del navegador. No es una implementación de producción del proxy ni del sitio. | ||
|
|
||
| Cuando termines de experimentar, detén ambos servicios locales y [limpia los recursos de Azure][cleanup]. Después, continúa con [Repaso y pasos siguientes][core-review] en la ruta principal del taller. |
|
|
||
| 資格情報を保護するローカルプロキシを構築し、アクセシビリティに配慮したチャットウィジェットを接続して、ホステッド Backer Concierge との会話フロー全体を検証しました。このモジュールのチェックポイントは、カタログの境界を維持し、資格情報と Foundry の内部識別子をブラウザーに公開しない、ローカルでテスト済みの Web サイト統合です。プロキシやサイトを本番環境にデプロイしたものではありません。 | ||
|
|
||
| 実験を終えたら、両方のローカルサービスを停止して、[Azure リソースをクリーンアップしてください][cleanup]。その後、コアワークショップのルートにある[振り返りと次のステップ][core-review]に進みます。 |
|
|
||
| 자격 증명을 안전하게 보호하는 로컬 프록시를 빌드하고 접근성 있는 채팅 위젯을 연결한 다음, 호스팅 Backer Concierge를 대상으로 전체 대화 흐름을 검증했습니다. 이 모듈의 체크포인트는 카탈로그 범위를 유지하고 자격 증명과 내부 Foundry 식별자를 브라우저에 노출하지 않는, 로컬에서 테스트한 웹사이트 통합입니다. 프록시나 사이트를 프로덕션에 배포한 것은 아닙니다. | ||
|
|
||
| 실험을 마치면 두 로컬 서비스를 모두 중지하고 [Azure 리소스를 정리합니다][cleanup]. 그런 다음 핵심 워크숍 경로의 [검토 및 다음 단계][core-review]로 계속 진행합니다. |
|
|
||
| Você criou um proxy local que protege as credenciais, conectou um widget de chat acessível e verificou todo o fluxo da conversa com o Backer Concierge hospedado. O ponto de verificação deste módulo é uma integração ao site testada localmente que preserva os limites do catálogo e mantém as credenciais e os identificadores internos do Foundry fora do navegador. Ela não representa uma implantação de produção do proxy ou do site. | ||
|
|
||
| Quando terminar de experimentar, interrompa os dois serviços locais e [limpe os recursos do Azure][cleanup]. Em seguida, continue para [Revisão e próximos passos][core-review] na rota principal do workshop. |
|
|
||
| 你已构建一个保护凭据的本地代理服务，连接支持无障碍访问的聊天组件，并针对托管的 Backer Concierge 验证了完整的对话流程。本模块的检查点是一个经过本地测试的网站集成，它能遵守目录边界，并且不会向浏览器暴露凭据或 Foundry 内部标识符。这并不代表代理服务或网站已部署到生产环境。 | ||
|
|
||
| 结束实验后，停止两个本地服务并[清理 Azure 资源][cleanup]。然后沿核心研讨会学习路径继续学习[回顾与后续步骤][core-review]。 |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Restructures the optional Copilot app Foundry workshop into an overview and three guided lessons, matching the workshop teaching pattern while preserving the existing entry route and required review lesson. This is a stacked follow-up that depends on #176; it does not replace or supersede that PR.
Type of change
website/Astro + Starlight wrapper).github/copilot-instructions.md, instructions, agents, skills)Verification
The source session completed verification against immutable Git tree
1edec403167f1dbd4f29e4ddeb1ca86fff0db045: approved lockednpm ci; the full build-and-verify-docs wrapper (check:allwith zero errors, clean build, Lychee with zero errors); source and generated-HTML checks for all 24 Foundry pages; and Playwright coverage of 47 routes, all HTTP 200 with no console/page errors, broken images, or raw callouts. Content alignment found no remaining drift, andgit diff --checkpassed.This publication session transferred that exact tree, verified both index and committed tree equality, and passed the staged whitespace check. No dependencies were installed or cloud commands executed here; the site checks were not rerun in this session.
Screenshots
All 11 existing images are preserved; no new screenshots. The source verification included rendered pages and image loading across the affected routes.
Notes for reviewers
copilot-app-foundry-agent(docs: add optional Backer Concierge AI Agent lesson (copilot app harness) #176), notmain. The original PR and source branch remain unchanged.README.md,1-project-and-model.md,2-build-and-deploy.md, and3-connect-to-site.md. English and all five locales (es-es,ja-jp,ko-kr,pt-br,zh-cn) are complete: 24 Foundry pages total.AUTHORING.md.azdis unavailable and protecting shared resource groups.