Skip to content

docs: restructure Foundry lessons to match workshop patterns (CLI harness) - #179

Open
GeekTrainer wants to merge 3 commits into
copilot-cli-foundry-agentfrom
geektrainer/foundry-agent-docs-refresh
Open

GeekTrainer wants to merge 3 commits into
copilot-cli-foundry-agentfrom
geektrainer/foundry-agent-docs-refresh

Conversation

@GeekTrainer

Copy link
Copy Markdown
Collaborator

Summary

Split the optional CLI Foundry exercise into an overview and three focused modules under Optional: Incorporate Foundry, with full translations in all five supported locales. This follow-up is stacked on #177 and preserves the existing series entry URL, technical prompts, commands, and images.

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

  • Type checks and a clean site build pass.
  • Affected pages and translations match their source and intended routes.
  • Offline internal link checks pass.
  • Changed external links have been checked separately. N/A: external destinations are unchanged.

Confirmed all 30 original fenced command/prompt blocks, explicit numbering, left-aligned callouts, and image paths. All 24 overview/module pages render their actual English or localized source, and localized cleanup anchors resolve. Browser checks covered module navigation and all 11 lesson images; the core workshop proceeds to review before the optional series.

Screenshots

No new screenshots attached; existing lesson images are preserved. The overview and nested sidebar were previewed locally.

Notes for reviewers

  • Depends on docs: add optional Backer Concierge AI Agent exercise (CLI harness) #177; intended base is copilot-cli-foundry-agent, not main.
  • Modules cover project/model preparation, agent development/deployment, and website integration.
  • Scenarios are narrative-only; instructional sections have lead-ins and numbered learner actions.
  • Shared cleanup is accessible from every stopping point, including before agent scaffolding.
  • Spanish, Japanese, Korean, Brazilian Portuguese, and Simplified Chinese have complete module translations, localized sidebar labels, aligned entry links, and corrected review numbering.
  • Existing site-wide plain-div admonition rendering and Astro deprecation hints are unchanged.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Copilot AI lite review requested due to automatic review settings September 16, 2026 17:14
@GeekTrainer
GeekTrainer changed the base branch from main to copilot-cli-foundry-agent September 16, 2026 17:14
@GeekTrainer
GeekTrainer added this pull request to stack #180 September 16, 2026 17:15
@GeekTrainer GeekTrainer changed the title docs: split optional Foundry series into localized modules docs: restructure Foundry lessons to match workshop patterns (CLI harness) Sep 16, 2026

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot review overview

🟡 Changes recommended

Unresolved moderate findings affect the installation command, model-selection prompt, and localized handoff links.

Get a fresh assessment by requesting another Copilot review.

Review effort: Lite
Findings: 2 Low severity

Open (2)
What changed in this PR

This PR splits the optional CLI Foundry exercise into an overview and three focused modules, with complete translations for five supported locales.

Changes:

  • Adds localized Foundry overview and module lessons.
  • Updates navigation, numbering, and handoffs.
  • Documents the multi-module authoring pattern.
File Reviewed change
website/​astro.config.mjs Adds nested Foundry sidebar navigation.
docs/​zh-cn/​cli/​README.md Updates the Chinese CLI overview and links.
docs/​zh-cn/​cli/​9-review.md Renumbers the Chinese review lesson and adds the Foundry handoff.
docs/​zh-cn/​cli/​8-foundry-agent/​README.md Adds the Chinese Foundry overview.
docs/​zh-cn/​cli/​8-foundry-agent/​3-connect-to-site.md Adds the Chinese site-integration module.
docs/​zh-cn/​cli/​8-foundry-agent/​2-build-and-deploy.md Adds the Chinese deployment module.
docs/​zh-cn/​cli/​8-foundry-agent/​1-project-and-model.md Adds the Chinese project/model module.
docs/​zh-cn/​cli/​7-slash-commands.md Adds Chinese optional-series navigation.
docs/​pt-br/​cli/​README.md Updates the Portuguese CLI overview and links.
docs/​pt-br/​cli/​9-review.md Renumbers the Portuguese review lesson and adds the Foundry handoff.
docs/​pt-br/​cli/​8-foundry-agent/​README.md Adds the Portuguese Foundry overview.
docs/​pt-br/​cli/​8-foundry-agent/​3-connect-to-site.md Adds the Portuguese site-integration module.
docs/​pt-br/​cli/​8-foundry-agent/​2-build-and-deploy.md Adds the Portuguese deployment module.
docs/​pt-br/​cli/​8-foundry-agent/​1-project-and-model.md Adds the Portuguese project/model module.
docs/​pt-br/​cli/​7-slash-commands.md Adds Portuguese optional-series navigation.
docs/​ko-kr/​cli/​README.md Updates the Korean CLI overview and links.
docs/​ko-kr/​cli/​9-review.md Renumbers the Korean review lesson and adds the Foundry handoff.
docs/​ko-kr/​cli/​8-foundry-agent/​README.md Adds the Korean Foundry overview.
docs/​ko-kr/​cli/​8-foundry-agent/​3-connect-to-site.md Adds the Korean site-integration module.
docs/​ko-kr/​cli/​8-foundry-agent/​2-build-and-deploy.md Adds the Korean deployment module.
docs/​ko-kr/​cli/​8-foundry-agent/​1-project-and-model.md Adds the Korean project/model module.
docs/​ko-kr/​cli/​7-slash-commands.md Adds Korean optional-series navigation.
docs/​ja-jp/​cli/​README.md Updates the Japanese CLI overview and links.
docs/​ja-jp/​cli/​9-review.md Renumbers the Japanese review lesson and adds the Foundry handoff.
docs/​ja-jp/​cli/​8-foundry-agent/​README.md Adds the Japanese Foundry overview.
docs/​ja-jp/​cli/​8-foundry-agent/​3-connect-to-site.md Adds the Japanese site-integration module.
docs/​ja-jp/​cli/​8-foundry-agent/​2-build-and-deploy.md Adds the Japanese deployment module.
docs/​ja-jp/​cli/​8-foundry-agent/​1-project-and-model.md Adds the Japanese project/model module.
docs/​ja-jp/​cli/​7-slash-commands.md Adds Japanese optional-series navigation.
docs/​es-es/​cli/​README.md Updates the Spanish CLI overview and links.
docs/​es-es/​cli/​9-review.md Renumbers the Spanish review lesson and adds the Foundry handoff.
docs/​es-es/​cli/​8-foundry-agent/​README.md Adds the Spanish Foundry overview.
docs/​es-es/​cli/​8-foundry-agent/​3-connect-to-site.md Adds the Spanish site-integration module.
docs/​es-es/​cli/​8-foundry-agent/​2-build-and-deploy.md Adds the Spanish deployment module.
docs/​es-es/​cli/​8-foundry-agent/​1-project-and-model.md Adds the Spanish project/model module.
docs/​es-es/​cli/​7-slash-commands.md Adds Spanish optional-series navigation.
docs/​cli/​README.md Updates the English CLI overview and links.
docs/​cli/​9-review.md Renumbers the English review lesson and adds the Foundry handoff.
docs/​cli/​8-foundry-agent/​README.md Adds the English Foundry overview.
docs/​cli/​8-foundry-agent/​3-connect-to-site.md Adds the English site-integration module.
docs/​cli/​8-foundry-agent/​2-build-and-deploy.md Adds the English deployment module.
docs/​cli/​8-foundry-agent/​1-project-and-model.md Adds the English project/model module.
docs/​cli/​7-slash-commands.md Adds English optional-series navigation.
AUTHORING.md Documents the optional multi-module series pattern.

💡 Configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

Comment thread docs/cli/8-foundry-agent/2-build-and-deploy.md Outdated
Comment thread docs/cli/README.md Outdated
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
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.

3 participants