Skip to content

Show the API-spec diff summary inline in the PR comment#51

Merged
turegjorup merged 2 commits into
developfrom
ci/oasdiff-inline-summary-comment
Jul 8, 2026
Merged

Show the API-spec diff summary inline in the PR comment#51
turegjorup merged 2 commits into
developfrom
ci/oasdiff-inline-summary-comment

Conversation

@turegjorup

Copy link
Copy Markdown
Contributor

Supersedes #50. Instead of disabling the oasdiff.com upload, keep it — but stop making reviewers click through to see the diff.

Changes

  • Both oasdiff steps: keep review: true (upload + review_url output) and set github-token: "" to suppress the action's own standalone link-only comment.
  • The workflow's existing sticky comment now renders the changelog inline in a collapsed <details> and appends a 🔍 View the full side-by-side review link (from steps.{breaking,changelog}.outputs.review_url).

Net result per PR (Codecov-style, one comment):

  • Non-breaking⚠️ headline + collapsed API changes summary + review link.
  • Breaking → 🛑 headline + collapsed summary + review link.
  • No changes → ✅ resolved (no link; the action returns an empty review_url when there's nothing to review).

Why

oasdiff-action v0.1.5 (#49) posts a link-only comment by default, so the actual diff lived only on oasdiff.com. This keeps the hosted side-by-side review available but surfaces the summary directly on the PR, so you don't have to leave GitHub for the common case. The upload behaviour is unchanged (the spec is public); only where the diff is shown changes.

Note: the API-spec workflow is path-filtered to spec-affecting paths, so the new comment first renders on the next PR that changes src/config/spec (e.g. #46 once it picks this up).

Keep the oasdiff.com upload (review: true) for the side-by-side review,
but suppress the action's standalone link-only comment (github-token: "")
and instead post a single sticky comment that carries the changelog
inline in a collapsed <details> plus the review link (from the
review_url output). Codecov-style: the diff summary is visible on the PR
without leaving GitHub, and the full side-by-side review is one click away.
@codecov-commenter

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 72.99%. Comparing base (191e1ed) to head (9da1a20).
⚠️ Report is 1 commits behind head on develop.

Additional details and impacted files
@@            Coverage Diff             @@
##             develop      #51   +/-   ##
==========================================
  Coverage      72.99%   72.99%           
  Complexity       232      232           
==========================================
  Files             29       29           
  Lines            648      648           
==========================================
  Hits             473      473           
  Misses           175      175           
Flag Coverage Δ
unittests 72.99% <ø> (ø)

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Harness.
📢 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.

@turegjorup turegjorup self-assigned this Jul 8, 2026
@turegjorup turegjorup merged commit 032c052 into develop Jul 8, 2026
11 checks passed
@turegjorup turegjorup deleted the ci/oasdiff-inline-summary-comment branch July 8, 2026 13:56
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants