[docs] LOC breakdown canvas contributor tool#1185
[docs] LOC breakdown canvas contributor tool#1185aspire-repo-bot[bot] wants to merge 1 commit intorelease/13.5microsoft/aspire.dev:release/13.5from docs/loc-breakdown-canvas-17829-08f77f80f301373dmicrosoft/aspire.dev:docs/loc-breakdown-canvas-17829-08f77f80f301373dCopy head branch name to clipboard
Conversation
Documents the .github/extensions/loc-breakdown Copilot CLI canvas extension added in microsoft/aspire#17829. The canvas shows a per-project breakdown of lines changed on the current branch and is available automatically to Aspire repository contributors using Copilot CLI. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
There was a problem hiding this comment.
Pull request overview
Adds documentation to aspire.dev for the new loc-breakdown Copilot CLI canvas extension introduced in microsoft/aspire#17829, and exposes it in the Community sidebar so contributors can discover it.
Changes:
- Add a new Community/Guides doc page describing what the LOC breakdown canvas reports and how to use/refresh it.
- Add the new page to the Community “Guides” sidebar section.
Reviewed changes
Copilot reviewed 2 out of 2 changed files in this pull request and generated 3 comments.
| File | Description |
|---|---|
| src/frontend/src/content/docs/community/loc-breakdown-canvas.mdx | New documentation page for the LOC breakdown Copilot CLI canvas extension. |
| src/frontend/config/sidebar/community.topics.ts | Adds the new doc page to the Community → Guides sidebar. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
| description: Use the LOC breakdown Copilot CLI canvas extension to view a per-project summary of lines changed on your branch when contributing to the Aspire repository. | ||
| --- | ||
|
|
||
| import { Steps, Aside } from "@astrojs/starlight/components"; |
|
|
||
| import { Steps, Aside } from "@astrojs/starlight/components"; | ||
|
|
||
| The `loc-breakdown` canvas is a project-scoped [Copilot CLI canvas extension](https://docs.github.com/en/copilot/using-github-copilot/coding-agent/using-copilot-coding-agent-in-your-ide) included in the Aspire repository under `.github/extensions/loc-breakdown/`. It shows a breakdown of the lines of code changed on the current branch, grouped by project or category, with a heuristic characterization of each group. |
| { | ||
| label: 'LOC breakdown canvas', | ||
| slug: 'community/loc-breakdown-canvas', | ||
| }, |
IEvangelist
left a comment
There was a problem hiding this comment.
Source-of-truth branch mismatch — review skipped
Cannot verify this PR against microsoft/aspire.
PR base branch (microsoft/aspire.dev) |
release/13.5 |
Matching branch in microsoft/aspire |
does not exist |
Latest release branch in microsoft/aspire |
release/13.4 (4f2189335) |
| Source PR cited in body | microsoft/aspire# — merged to main, milestone 13.5 |
My review protocol requires using the matching microsoft/aspire release branch as the single source of truth for claim verification. Because no release/13.5 branch exists on microsoft/aspire yet (13.5 has not been cut), I cannot verify the API/CLI/config claims in this PR against an authoritative source code snapshot for that release.
Possible resolutions:
- Re-target this PR to
release/13.4inaspire.devif the documented behavior is already present in 13.4. - Wait until
release/13.5is cut inmicrosoft/aspire, then re-run review against that branch.
Skipping Phase B (doc-tester) as well — running it without the Phase A claim verification would produce an incomplete review per protocol.
|
Blocked from applying review feedback: this docs PR targets Per the docs-feedback responder rules, I'm exiting without editing or resolving threads until a matching |
Documents changes from microsoft/aspire#17829 (
@mitchdenny).Targeting
release/13.4— the latest release branch onmicrosoft/aspire.dev— becauserelease/13.5(from the source PR milestone13.5) does not exist there.Why this PR is needed
PR microsoft/aspire#17829 adds a new Copilot CLI canvas extension under
.github/extensions/loc-breakdown/in the Aspire repository. The extension is automatically available to Aspire repository contributors using Copilot CLI and provides a per-project breakdown of lines changed on the current branch. The PR includes a## Usagesection describing how contributors invoke the canvas and its optional inputs (cwd,base,head).What was documented
A new page was added to the Community / Guides section covering:
cwd,base,head)Files modified
src/frontend/src/content/docs/community/loc-breakdown-canvas.mdxsrc/frontend/config/sidebar/community.topics.ts— adds the new page to the Guides section of the community sidebar