docs: review and standardize Spanish localization terminology by elbruno · Pull Request #158 · github-samples/copilot-workshops

elbruno · 2026-07-28T13:49:08Z

Description

Comprehensive line-by-line review of Spanish localization in docs/es-es/ to ensure translation quality, terminological consistency, and content completeness.

Changes

✅ Reviewed all 21 files in Spanish localization (10 app + 10 cli + 1 README root)
🔧 Standardized terminology: Changed "estándares de programación" → "estándares de desarrollo" for consistency across harnesses
- Affected files:
  - docs/es-es/app/3-custom-instructions.md (line 77)
  - docs/es-es/README.md (line 38)
✅ Quality assessment: 99/100 (minor terminology issue resolved)

Translation Quality

Fidelity: 100/100 — All content 100% parallel to English
Coherence: 100/100 — Terminology consistent across harnesses
Formatting: 100/100 — Markdown, admonitions, links all correct
Pedagogy: 99/100 — Excellent readability and instructional flow

All files reviewed are translation-complete and pedagogically sound. No additional issues found.

Co-authored-by: Copilot 223556219+Copilot@users.noreply.github.com

Translate all 10 CLI lesson files into 5 locales following the localizations skill rules. Each locale directory mirrors the docs/cli/ structure with properly adjusted image paths and locale-prefixed slugs on landing pages. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Copilot-Session: eb23f3ee-d867-4f36-8fd9-0451285c3511

…ed CLI content Update Copilot CLI links in locale root READMEs (../cli/ → cli/) and app 8-review.md cross-references (../../cli/ → ../cli/) so readers stay within the translated content. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

…nslations Add CLI translations for 5 locales

…e-cli-translations Revert "Add CLI translations for 5 locales"

This reverts commit 4adc41f.

…res de desarrollo" in documentation Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Copilot

Pull request overview

This PR updates localized workshop documentation under docs/ (notably adding full Copilot CLI lesson sets for multiple locales) and adjusts a website/ build configuration entry. It also standardizes a Spanish terminology choice (“estándares de programación” → “estándares de desarrollo”) and updates some localized navigation links.

Changes:

Added localized Copilot CLI lesson content for es-es, pt-br, zh-cn, ja-jp, and ko-kr.
Updated localized landing pages to link to the localized CLI paths (e.g., cli/).
Tweaked Spanish wording in docs/es-es/README.md and docs/es-es/app/3-custom-instructions.md, and added allowScripts in website/package.json.

Show a summary per file

File	Description
website/package.json	Adds `allowScripts` configuration (build/install behavior change).
docs/zh-cn/README.md	Fixes localized CLI link to point to `zh-cn/cli/`.
docs/zh-cn/cli/README.md	Adds zh-cn CLI landing page and lesson index.
docs/zh-cn/cli/0-prerequisites.md	Adds zh-cn CLI Exercise 0.
docs/zh-cn/cli/1-install-copilot-cli.md	Adds zh-cn CLI Exercise 1.
docs/zh-cn/cli/3-generating-code.md	Adds zh-cn CLI Exercise 3.
docs/zh-cn/cli/4-mcp.md	Adds zh-cn CLI Exercise 4.
docs/zh-cn/cli/5-agent-skills.md	Adds zh-cn CLI Exercise 5.
docs/zh-cn/cli/6-custom-agents.md	Adds zh-cn CLI Exercise 6.
docs/zh-cn/cli/7-slash-commands.md	Adds zh-cn CLI Exercise 7.
docs/zh-cn/cli/8-review.md	Adds zh-cn CLI Exercise 8.
docs/zh-cn/app/8-review.md	Updates zh-cn app review page navigation link (currently broken; needs fix).
docs/pt-br/README.md	Fixes localized CLI link to point to `pt-br/cli/`.
docs/pt-br/cli/README.md	Adds pt-br CLI landing page and lesson index.
docs/pt-br/cli/0-prerequisites.md	Adds pt-br CLI Lesson 0.
docs/pt-br/cli/1-install-copilot-cli.md	Adds pt-br CLI Lesson 1.
docs/pt-br/cli/3-generating-code.md	Adds pt-br CLI Lesson 3.
docs/pt-br/cli/4-mcp.md	Adds pt-br CLI Lesson 4.
docs/pt-br/cli/5-agent-skills.md	Adds pt-br CLI Lesson 5.
docs/pt-br/cli/6-custom-agents.md	Adds pt-br CLI Lesson 6.
docs/pt-br/cli/7-slash-commands.md	Adds pt-br CLI Lesson 7.
docs/pt-br/cli/8-review.md	Adds pt-br CLI Lesson 8.
docs/pt-br/app/8-review.md	Updates pt-br app review page navigation link (currently broken; needs fix).
docs/ko-kr/README.md	Fixes localized CLI link to point to `ko-kr/cli/`.
docs/ko-kr/cli/README.md	Adds ko-kr CLI landing page and lesson index.
docs/ko-kr/cli/0-prerequisites.md	Adds ko-kr CLI Exercise 0.
docs/ko-kr/cli/1-install-copilot-cli.md	Adds ko-kr CLI Exercise 1.
docs/ko-kr/cli/3-generating-code.md	Adds ko-kr CLI Exercise 3.
docs/ko-kr/cli/5-agent-skills.md	Adds ko-kr CLI Exercise 5.
docs/ko-kr/cli/6-custom-agents.md	Adds ko-kr CLI Exercise 6.
docs/ko-kr/cli/8-review.md	Adds ko-kr CLI Exercise 8.
docs/ko-kr/app/8-review.md	Updates ko-kr app review page navigation link (currently broken; needs fix).
docs/ja-jp/README.md	Fixes localized CLI link to point to `ja-jp/cli/`.
docs/ja-jp/cli/README.md	Adds ja-jp CLI landing page and lesson index.
docs/ja-jp/cli/0-prerequisites.md	Adds ja-jp CLI Exercise 0.
docs/ja-jp/cli/1-install-copilot-cli.md	Adds ja-jp CLI Exercise 1.
docs/ja-jp/cli/3-generating-code.md	Adds ja-jp CLI Exercise 3.
docs/ja-jp/cli/5-agent-skills.md	Adds ja-jp CLI Exercise 5.
docs/ja-jp/cli/6-custom-agents.md	Adds ja-jp CLI Exercise 6.
docs/ja-jp/cli/8-review.md	Adds ja-jp CLI Exercise 8.
docs/ja-jp/app/8-review.md	Updates ja-jp app review page navigation link (currently broken; needs fix).
docs/es-es/README.md	Updates Spanish terminology + fixes localized CLI link to point to `es-es/cli/`.
docs/es-es/cli/README.md	Adds es-es CLI landing page and lesson index.
docs/es-es/cli/0-prerequisites.md	Adds es-es CLI Exercise 0.
docs/es-es/cli/1-install-copilot-cli.md	Adds es-es CLI Exercise 1.
docs/es-es/cli/3-generating-code.md	Adds es-es CLI Exercise 3.
docs/es-es/cli/4-mcp.md	Adds es-es CLI Exercise 4.
docs/es-es/cli/5-agent-skills.md	Adds es-es CLI Exercise 5.
docs/es-es/cli/6-custom-agents.md	Adds es-es CLI Exercise 6.
docs/es-es/cli/7-slash-commands.md	Adds es-es CLI Exercise 7.
docs/es-es/cli/8-review.md	Adds es-es CLI Exercise 8.
docs/es-es/app/8-review.md	Updates es-es app review page navigation link (currently broken; needs fix).
docs/es-es/app/3-custom-instructions.md	Updates Spanish terminology (“estándares de desarrollo”).

Review details

Files reviewed: 62/62 changed files
Comments generated: 6
Review effort level: Low

 A melhor maneira de melhorar com qualquer ferramenta é continuar usando-a. Use-a em código de produção, em projetos pessoais ou naquele pequeno aplicativo que você planeja criar há anos. Compartilhe o que aprendeu com sua equipe e aprenda com as experiências dela. E, como sempre, explore a documentação.

-Para conhecer melhor o ecossistema do GitHub Copilot, confira o [percurso do VS Code](../../vscode/), o [percurso do Copilot CLI](../../cli/) ou o [percurso do agente de nuvem](../../cloud/).
+Para conhecer melhor o ecossistema do GitHub Copilot, confira o [percurso do VS Code](../../vscode/), o [percurso do Copilot CLI](../cli/) ou o [percurso do agente de nuvem](../../cloud/).


 어떤 도구든 더 능숙하게 사용하려면 계속 사용해야 합니다. 프로덕션 코드, 취미 프로젝트, 오랫동안 생각만 하고 만들지 못했던 작은 앱에 사용해 봅니다. 배운 내용을 팀과 공유하고 팀의 경험에서도 배웁니다. 언제나 그렇듯 문서를 살펴봅니다.

-GitHub Copilot 생태계를 더 살펴보려면 [VS Code 실습 과정](../../vscode/), [Copilot CLI 실습 과정](../../cli/), [Cloud agent 실습 과정](../../cloud/)을 확인합니다.
+GitHub Copilot 생태계를 더 살펴보려면 [VS Code 실습 과정](../../vscode/), [Copilot CLI 실습 과정](../cli/), [Cloud agent 실습 과정](../../cloud/)을 확인합니다.


 ツールを使いこなす最良の方法は、使い続けることです。実稼働コード、趣味のコード、長年構想していながら構築できていなかった小さなアプリなどに活用してください。学んだことをチームと共有し、チームからも学びましょう。そして、引き続きドキュメントを確認してください。

-GitHub Copilot エコシステムをさらに学ぶには、[VS Code ハーネス](../../vscode/)、[Copilot CLI ハーネス](../../cli/)、[Cloud agent ハーネス](../../cloud/)を確認してください。
+GitHub Copilot エコシステムをさらに学ぶには、[VS Code ハーネス](../../vscode/)、[Copilot CLI ハーネス](../cli/)、[Cloud agent ハーネス](../../cloud/)を確認してください。


 熟练使用任何工具的最佳方式都是持续使用。可将它用于生产代码、业余项目，或那个构思多年却始终没有动手构建的小应用。与团队分享经验，也向团队学习。并且一如既往地探索文档。

-要探索 GitHub Copilot 生态系统的更多内容，请查看 [VS Code 学习路径](../../vscode/)、[Copilot CLI 学习路径](../../cli/)或 [Cloud agent 学习路径](../../cloud/)。
+要探索 GitHub Copilot 生态系统的更多内容，请查看 [VS Code 学习路径](../../vscode/)、[Copilot CLI 学习路径](../cli/)或 [Cloud agent 学习路径](../../cloud/)。


  "devDependencies": {
    "@typescript/native-preview": "^7.0.0-dev.20260707.2",
    "remark-github-admonitions-to-directives": "^2.1.0"
+  },
+  "allowScripts": {
+    "esbuild@0.28.1": true
  }


Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

katiesavage and others added 8 commits July 24, 2026 14:51

chore: allow esbuild script in package.json

038838b

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Merge pull request katiesavage#1 from katiesavage/katiesavage-cli-tra…

b65346b

…nslations Add CLI translations for 5 locales

Revert "Add CLI translations for 5 locales"

4adc41f

Merge pull request katiesavage#2 from katiesavage/revert-1-katiesavag…

476954d

…e-cli-translations Revert "Add CLI translations for 5 locales"

Reapply "Add CLI translations for 5 locales"

c5106fc

This reverts commit 4adc41f.

fix: update terminology from "estándares de programación" to "estánda…

703e10e

…res de desarrollo" in documentation Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Copilot AI review requested due to automatic review settings July 28, 2026 13:49

Copilot started reviewing on behalf of elbruno July 28, 2026 13:49 View session

Copilot AI reviewed Jul 28, 2026

View reviewed changes

Potential fix for pull request finding

02826ff

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

elbruno closed this Jul 28, 2026

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

docs: review and standardize Spanish localization terminology - #158

docs: review and standardize Spanish localization terminology#158
elbruno wants to merge 9 commits into
github-samples:mainfrom
elbruno:fix-cli-translations

elbruno commented Jul 28, 2026

Uh oh!

Copilot AI left a comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Uh oh!

Conversation

elbruno commented Jul 28, 2026

Description

Changes

Translation Quality

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Review details

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants