Repository navigation
docs: clarify first-steps review access and app workflows - #196
Merged
Merged
Conversation
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Contributor
There was a problem hiding this comment.
Copilot review overview
🟢 Approval recommended
The workflows, links, commands, and localized counterparts are complete and consistently aligned.
Review effort: Balanced
Findings: None
What changed in this PR
Clarifies feature access and corrects first-steps workflows across English and five localized editions.
Changes:
- Documents code-review eligibility and manual alternatives.
- Corrects session inspection,
/init, and publishing guidance. - Keeps all localized lessons aligned.
| File | Description |
|---|---|
docs/first-steps/copilot-app/0-prerequisites.md |
Adds review-access prerequisite. |
docs/first-steps/copilot-app/3-inspect-and-test.md |
Corrects local-session inspection. |
docs/first-steps/copilot-app/4-project-instructions.md |
Adds required /init input. |
docs/first-steps/copilot-app/5-publish.md |
Clarifies approval behavior. |
docs/first-steps/copilot-app/8-review-loop.md |
Adds manual-review alternative. |
docs/first-steps/copilot-cli/2-project-instructions.md |
Adds required /init input. |
docs/first-steps/vscode/0-prerequisites.md |
Adds review-access prerequisite. |
docs/first-steps/vscode/2-project-instructions.md |
Updates the /init command. |
docs/first-steps/vscode/8-review-and-merge.md |
Clarifies review eligibility. |
docs/es-es/first-steps/copilot-app/0-prerequisites.md |
Localizes review prerequisite. |
docs/es-es/first-steps/copilot-app/3-inspect-and-test.md |
Localizes session corrections. |
docs/es-es/first-steps/copilot-app/4-project-instructions.md |
Localizes /init guidance. |
docs/es-es/first-steps/copilot-app/5-publish.md |
Localizes approval guidance. |
docs/es-es/first-steps/copilot-app/8-review-loop.md |
Localizes review alternative. |
docs/es-es/first-steps/copilot-cli/2-project-instructions.md |
Localizes /init guidance. |
docs/es-es/first-steps/vscode/0-prerequisites.md |
Localizes review prerequisite. |
docs/es-es/first-steps/vscode/2-project-instructions.md |
Localizes the /init command. |
docs/es-es/first-steps/vscode/8-review-and-merge.md |
Localizes eligibility guidance. |
docs/ja-jp/first-steps/copilot-app/0-prerequisites.md |
Localizes review prerequisite. |
docs/ja-jp/first-steps/copilot-app/3-inspect-and-test.md |
Localizes session corrections. |
docs/ja-jp/first-steps/copilot-app/4-project-instructions.md |
Localizes /init guidance. |
docs/ja-jp/first-steps/copilot-app/5-publish.md |
Localizes approval guidance. |
docs/ja-jp/first-steps/copilot-app/8-review-loop.md |
Localizes review alternative. |
docs/ja-jp/first-steps/copilot-cli/2-project-instructions.md |
Localizes /init guidance. |
docs/ja-jp/first-steps/vscode/0-prerequisites.md |
Localizes review prerequisite. |
docs/ja-jp/first-steps/vscode/2-project-instructions.md |
Localizes the /init command. |
docs/ja-jp/first-steps/vscode/8-review-and-merge.md |
Localizes eligibility guidance. |
docs/ko-kr/first-steps/copilot-app/0-prerequisites.md |
Localizes review prerequisite. |
docs/ko-kr/first-steps/copilot-app/3-inspect-and-test.md |
Localizes session corrections. |
docs/ko-kr/first-steps/copilot-app/4-project-instructions.md |
Localizes /init guidance. |
docs/ko-kr/first-steps/copilot-app/5-publish.md |
Localizes approval guidance. |
docs/ko-kr/first-steps/copilot-app/8-review-loop.md |
Localizes review alternative. |
docs/ko-kr/first-steps/copilot-cli/2-project-instructions.md |
Localizes /init guidance. |
docs/ko-kr/first-steps/vscode/0-prerequisites.md |
Localizes review prerequisite. |
docs/ko-kr/first-steps/vscode/2-project-instructions.md |
Localizes the /init command. |
docs/ko-kr/first-steps/vscode/8-review-and-merge.md |
Localizes eligibility guidance. |
docs/pt-br/first-steps/copilot-app/0-prerequisites.md |
Localizes review prerequisite. |
docs/pt-br/first-steps/copilot-app/3-inspect-and-test.md |
Localizes session corrections. |
docs/pt-br/first-steps/copilot-app/4-project-instructions.md |
Localizes /init guidance. |
docs/pt-br/first-steps/copilot-app/5-publish.md |
Localizes approval guidance. |
docs/pt-br/first-steps/copilot-app/8-review-loop.md |
Localizes review alternative. |
docs/pt-br/first-steps/copilot-cli/2-project-instructions.md |
Localizes /init guidance. |
docs/pt-br/first-steps/vscode/0-prerequisites.md |
Localizes review prerequisite. |
docs/pt-br/first-steps/vscode/2-project-instructions.md |
Localizes the /init command. |
docs/pt-br/first-steps/vscode/8-review-and-merge.md |
Localizes eligibility guidance. |
docs/zh-cn/first-steps/copilot-app/0-prerequisites.md |
Localizes review prerequisite. |
docs/zh-cn/first-steps/copilot-app/3-inspect-and-test.md |
Localizes session corrections. |
docs/zh-cn/first-steps/copilot-app/4-project-instructions.md |
Localizes /init guidance. |
docs/zh-cn/first-steps/copilot-app/5-publish.md |
Localizes approval guidance. |
docs/zh-cn/first-steps/copilot-app/8-review-loop.md |
Localizes review alternative. |
docs/zh-cn/first-steps/copilot-cli/2-project-instructions.md |
Localizes /init guidance. |
docs/zh-cn/first-steps/vscode/0-prerequisites.md |
Localizes review prerequisite. |
docs/zh-cn/first-steps/vscode/2-project-instructions.md |
Localizes the /init command. |
docs/zh-cn/first-steps/vscode/8-review-and-merge.md |
Localizes eligibility guidance. |
💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.
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
Prevent learners from reaching unavailable PR review features or following app instructions that do not match a local-folder session and its approval settings. Clarify Copilot Free review eligibility, provide a manual-review alternative, and correct session inspection,
/initinput, and publishing guidance across English and all five translations./init create simple rules for the projectin app, CLI, and VS Code execution steps, explaining the missing-input error in the app and CLI lessons.Type of change
website/Astro + Starlight wrapper).github/copilot-instructions.md, instructions, agents, skills)Verification
Commands and results:
npm.cmd ci --no-audit --no-fundinwebsite: passed; restored the existing lockfile dependencies after the initial verification attempt reported missing Astro.& .\.github\skills\build-and-verify-docs\scripts\verify.ps1: passed, includingnpm run check:all, a cleannpm run build, and offline Lychee validation with 0 link errors. Type checks reported 0 errors, 0 warnings, and 4 existing hints.git diff --checkandgit diff --cached --check: passed.Source-to-built HTML inspection passed for all 54 changed lessons: expected routes, titles, locale languages, command examples, callout text, and updated reference destinations. Reviewed parallel lessons and all five translations for content alignment. Checked the new GitHub code-review documentation destination and its eligibility guidance separately.
Screenshots
N/A. No image or layout changes; the existing session-details illustration is now explicitly labeled as a later Git-backed example.
Notes for reviewers
The organization-paid review exception applies on GitHub.com and does not grant IDE review access. Bare
/initremains as the command name in headings and conceptual descriptions, while execution steps include a prompt.Browser QA was not run because Playwright MCP tools were unavailable. The existing plain-div admonition rendering is unchanged; this PR does not change site-shell styling.