Repository navigation
docs: update app workshops for Issues and Pull requests and sync first steps with upstream - #194
Merged
Merged
Conversation
Sync the Copilot app first steps workshop with upstream jamesmontemagno/first-steps-with-github-copilot#11. The app replaced My work with separate Pull requests and Issues views, so update the workspace overview, the issue and plan lessons, and the Canvas fallback note. Redraw the Issues illustration and refresh the Automations sidebar from upstream art.js. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Sync the Copilot app first steps workshop with upstream jamesmontemagno/first-steps-with-github-copilot#10. /remote makes a local session available on the web and in the GitHub Copilot mobile app; it does not move execution to the cloud, and the machine must stay on. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Contributor
There was a problem hiding this comment.
Copilot review overview
🟡 Changes recommended
Related CLI, real-world app, and localized lessons still teach outdated, contradictory product behavior.
Review effort: Balanced
Findings: 2
Open (2)
What changed in this PR
Updates the first-steps Copilot app workshop for the current Issues navigation and /remote behavior.
Changes:
- Replaces My work instructions with Issues and Pull requests.
- Clarifies that remote sessions continue running locally.
- Refreshes Issues and Automations illustrations.
| File | Description |
|---|---|
docs/first-steps/copilot-app/README.md |
Updates the remote lesson summary. |
docs/first-steps/copilot-app/0-prerequisites.md |
Documents the new sidebar navigation. |
docs/first-steps/copilot-app/6-issues-and-sessions.md |
Revises the Issues workflow and illustration. |
docs/first-steps/copilot-app/7-plan-mode.md |
Directs learners to Issues. |
docs/first-steps/copilot-app/10-remote.md |
Corrects /remote execution semantics. |
docs/first-steps/copilot-app/11-canvas.md |
Updates the accessible fallback path. |
docs/first-steps/copilot-app/12-review.md |
Revises the remote-session recap. |
docs/_images/first-steps-app-issues.svg |
Adds the current Issues view. |
docs/_images/first-steps-app-automations.svg |
Refreshes the application sidebar. |
💡 Configure MCP servers for context-aware, tailored reviews. Learn more in the docs.
Port the CLI and VS Code parts of upstream jamesmontemagno/first-steps-with-github-copilot#10. The CLI lesson now says /remote keeps the session running locally and the machine must stay on, and no longer suggests closing the laptop. The CLI delegate and VS Code cloud session lessons note that they need an eligible paid Copilot plan. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Sync all three first steps workshops with upstream jamesmontemagno/first-steps-with-github-copilot@db820cd. The prerequisites now link to GitHub signup, name Copilot Free or a paid plan, and tell learners to use organization-provided access where they have it. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
… workshop The app's My work view is now separate Pull requests and Issues views. Update the workspace overview, the seeded backlog steps, and the issue-linked session steps in lessons 1, 3, and the Foundry module, in English and the five translations. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
The hint was not in upstream and assumed the default Issues view only lists assigned issues. Unassigned issues appear there, so the hint is not needed. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
8 of 17 tasks
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
Updates the workshops for two changes in the GitHub Copilot app and syncs the three first steps workshops with upstream. The app's My work view is now separate Pull requests and Issues views, so every lesson that sent learners to My work is updated: the first steps app tour and the real-world app workshop, including its five translations. The first steps workshops also pick up the corrected
/remoteand plan-access guidance and the expanded prerequisites.es-es,ja-jp,ko-kr,pt-br, andzh-cn./remoteruns locally/delegateand cloud sessions need an eligible paid Copilot plan.Illustrations:
first-steps-app-my-work.svgis redrawn and renamed tofirst-steps-app-issues.svg, andfirst-steps-app-automations.svggets the new sidebar. Both were generated by running upstreamlabs/art.jsand wrapping the output in the existing theme-aware style block, so the diff against the previous files is limited to the drawing. The real-world app screenshots did not need changes: the three I checked (app-new-session-from-issue.png,app-2-review-panel.png,app-select-changes.png) are crops that do not show the sidebar.Type of change
website/Astro + Starlight wrapper).github/copilot-instructions.md, instructions, agents, skills)Verification
Ran
& ./.github/skills/build-and-verify-docs/scripts/verify.ps1on Windows against the final content (exit code 0):npm run check:allzdeprecation hints insrc/content.config.ts)npm run buildlychee --offline --no-progressInspected the built HTML:
/first-steps/copilot-app/,/first-steps/copilot-cli/, and/first-steps/vscode/carry the new text. Lesson 6 points at the renamedfirst-steps-app-issuesasset, and nofirst-steps-app-my-workasset is emitted. First steps has no translated pages.External links: the one new link,
https://github.com/signup, returned 403 to scripted requests, so @jamesmontemagno confirmed it in a browser.Not run: the browser validation pass in
validate-site-playwright. I rasterized the two SVGs in headless Edge to check the drawing, in the light theme only.Screenshots
Issues view (first steps app lesson 6):
Automations view with the new sidebar (first steps app lesson 9):
Notes for reviewers
github-actions[bot]and are unassigned, and they still appear in the default Issues view. The Issues and Pull requests lists only show repositories added to the app, so the real-world lesson 1 note is kept and renamed.mainon October 5 while this PR was in progress. If that wording is not final, commit973e30ahere can be dropped on its own./delegateand cloud sessions need "an eligible paid Copilot plan". The real-world app lesson 1 says the app needs Copilot Student or a paid plan, and the real-world cloud landing page says cloud agent is on every plan except Copilot Free, which includes Copilot Student. I kept upstream's wording and did not check either claim against the product.lastUpdateddate was left alone.<div>elements in the built HTML, the same as the unchanged Plan mode tip in app lesson 7. That behavior predates this PR.