Skip to content

App graph viz gh feature spec#11602

Draft
willtsai wants to merge 15 commits intoradius-project:mainfrom
willtsai:app-graph-viz-gh-feature-spec
Draft

App graph viz gh feature spec#11602
willtsai wants to merge 15 commits intoradius-project:mainfrom
willtsai:app-graph-viz-gh-feature-spec

Conversation

@willtsai
Copy link
Copy Markdown
Contributor

@willtsai willtsai commented Apr 8, 2026

Description

Adding feature specification for the the app graph visualization user experience in GitHub.

Type of change

  • This pull request adds or changes features of Radius and has an approved issue (issue link required).

Fixes: #11319

Contributor checklist

Please verify that the PR meets the following requirements, where applicable:

  • An overview of proposed schema changes is included in a linked GitHub issue.
    • Yes
    • Not applicable
  • A design document PR is created in the design-notes repository, if new APIs are being introduced.
    • Yes
    • Not applicable
  • The design document has been reviewed and approved by Radius maintainers/approvers.
    • Yes
    • Not applicable
  • A PR for the samples repository is created, if existing samples are affected by the changes in this PR.
    • Yes
    • Not applicable
  • A PR for the documentation repository is created, if the changes in this PR affect the documentation or any user facing updates are made.
    • Yes
    • Not applicable
  • A PR for the recipes repository is created, if existing recipes are affected by the changes in this PR.
    • Yes
    • Not applicable

willtsai added 8 commits April 7, 2026 10:37
Signed-off-by: Will Tsai <28876888+willtsai@users.noreply.github.com>
Signed-off-by: Will Tsai <28876888+willtsai@users.noreply.github.com>
Signed-off-by: Will Tsai <28876888+willtsai@users.noreply.github.com>
Signed-off-by: Will Tsai <28876888+willtsai@users.noreply.github.com>
Signed-off-by: Will Tsai <28876888+willtsai@users.noreply.github.com>
Signed-off-by: Will Tsai <28876888+willtsai@users.noreply.github.com>
@willtsai willtsai requested a review from a team as a code owner April 8, 2026 15:53
Copilot AI review requested due to automatic review settings April 8, 2026 15:53
@willtsai willtsai requested a review from a team as a code owner April 8, 2026 15:53
@willtsai willtsai requested a deployment to external-contributor-approval April 8, 2026 15:53 — with GitHub Actions Waiting
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

Adds a new engineering design note describing the intended GitHub user experience for Radius “app graph” visualization (PR graph diffs, README diagram updates, and dedicated graph pages), along with supporting screenshots.

Changes:

  • Add a feature spec design note for GitHub app graph visualization UX.
  • Add/update screenshot assets referenced by the spec.

Reviewed changes

Copilot reviewed 1 out of 23 changed files in this pull request and generated 5 comments.

File Description
eng/design-notes/app-graph/2026-04-github-app-graph-visualization-feature-spec.md New feature spec describing scenarios, UX flows, and integration points.
eng/design-notes/app-graph/2026-04-github-app-graph-visualization-feature-spec/image02.png Screenshot asset referenced by the spec.
eng/design-notes/app-graph/2026-04-github-app-graph-visualization-feature-spec/image09.png Screenshot asset referenced by the spec.

Comment thread eng/design-notes/app-graph/2026-04-github-app-graph-visualization-feature-spec.md Outdated
Comment thread eng/design-notes/app-graph/2026-04-github-app-graph-visualization-feature-spec.md Outdated
@codecov
Copy link
Copy Markdown

codecov bot commented Apr 8, 2026

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 51.41%. Comparing base (9b812b3) to head (edcac9d).
⚠️ Report is 2 commits behind head on main.

Additional details and impacted files
@@            Coverage Diff             @@
##             main   #11602      +/-   ##
==========================================
+ Coverage   51.38%   51.41%   +0.03%     
==========================================
  Files         699      699              
  Lines       44114    44114              
==========================================
+ Hits        22666    22680      +14     
+ Misses      19279    19272       -7     
+ Partials     2169     2162       -7     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

@willtsai willtsai marked this pull request as draft April 8, 2026 17:10
@willtsai willtsai requested a deployment to external-contributor-approval April 8, 2026 17:11 — with GitHub Actions Waiting
…ion-feature-spec.md

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Signed-off-by: Will <28876888+willtsai@users.noreply.github.com>
@willtsai willtsai requested a deployment to external-contributor-approval April 8, 2026 17:14 — with GitHub Actions Waiting
Comment thread eng/design-notes/app-graph/2026-04-github-app-graph-visualization-feature-spec.md Outdated
Comment thread eng/design-notes/app-graph/2026-04-github-app-graph-visualization-feature-spec.md Outdated
Comment thread eng/design-notes/app-graph/2026-04-github-app-graph-visualization-feature-spec.md Outdated
Comment thread eng/design-notes/app-graph/2026-04-github-app-graph-visualization-feature-spec.md Outdated
Signed-off-by: Will Tsai <28876888+willtsai@users.noreply.github.com>
@willtsai willtsai requested a deployment to external-contributor-approval April 8, 2026 22:12 — with GitHub Actions Waiting
Signed-off-by: Will Tsai <28876888+willtsai@users.noreply.github.com>
@willtsai willtsai requested a deployment to external-contributor-approval April 8, 2026 22:15 — with GitHub Actions Waiting
Signed-off-by: Will Tsai <28876888+willtsai@users.noreply.github.com>
@willtsai willtsai requested a deployment to external-contributor-approval April 8, 2026 23:12 — with GitHub Actions Waiting
Signed-off-by: Will Tsai <28876888+willtsai@users.noreply.github.com>
@willtsai willtsai requested a deployment to external-contributor-approval April 8, 2026 23:13 — with GitHub Actions Waiting
Signed-off-by: Will Tsai <28876888+willtsai@users.noreply.github.com>
@willtsai willtsai requested a deployment to external-contributor-approval April 8, 2026 23:28 — with GitHub Actions Waiting
Just like in the PR views, the app graph visualization is an interactive UI component that the user may click to navigate into the relevant parts of the code in the repo on GitHub:

![alt text](2026-04-github-app-graph-visualization-feature-spec/image14.png)

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Add another (P2) scenario for the ability to (1) link to and embed an app graph into a website or .md file, e.g. user can add an embedded app graph into their README that would reflect the latest app graph in main and (2) add a widget to a user's GitHub profile that allows them to showcase the app graphs of all the applications they maintain or work on.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

App graph in GitHub: Updated spec and plan

8 participants