Skip to content

meta: build docs for PRs whose base has no main run - #1248

Merged
ovflowd merged 1 commit into
mainfrom
meta/compare-stacked-prs
Nov 6, 2026
Merged

ovflowd merged 1 commit into
mainfrom
meta/compare-stacked-prs

Conversation

@ovflowd

@ovflowd ovflowd commented Nov 6, 2026 •

Copy link
Copy Markdown
Member

Description

This PR stops "Generate and Compare Docs" from failing on PRs whose base has no main run, like the stacked ones in #1238 to #1243.

prepare looks up the latest run of generate.yml for the PR's base commit and downloads the nodejs/node SHA it built. A PR stacked on another PR's branch has a base commit no run ever built, so the download failed with "Artifact not found for name: commit" and generate never ran. Without a base run, prepare now skips the download and builds from the latest nodejs/node SHA, as a push to main does. generate already skips the comparison when there's no base run, so these PRs still build every target, just without comparing.

Validation

zizmor reports nothing new (the same 6 suppressed findings as on main), and the format check passes. This PR targets main, so its own run still goes through the download and the comparison; the stacked PRs will show the other path once they're rebased onto it.

Related Issues

Refs: #1238

Check List

  • I have read the Contributing Guidelines and made commit messages that follow the guideline.
  • I have run node --run test and all tests passed.
  • I have check code formatting with node --run format:check & node --run lint.
  • I've covered new added functionality with unit tests if necessary.

prepare downloads the nodejs/node SHA that the latest `main` run of
generate.yml used for the PR's base commit. A PR stacked on another
PR's branch has a base commit no such run built, so the download failed
and generate never ran.

Without a base run, prepare now skips the download and builds from the
latest SHA of nodejs/node, as a push to main does. generate already
skips the comparison when there's no base run, so these PRs still build
every target, without a comparison.

Assisted-by: Claude Opus 5.5 <noreply@anthropic.com>
@vercel

vercel Bot commented Nov 6, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
api-docs-tooling Ready Ready Preview Nov 6, 2026 5:21pm UTC

Request Review

@ovflowd
ovflowd requested a review from a team as a code owner November 6, 2026 17:21
@ovflowd ovflowd added the fast track This PR can land before the typical review time, with a :+1: from collaborators label Nov 6, 2026
@cloudflare-workers-and-pages

Copy link
Copy Markdown

🚀 Deploying Preview to Cloudflare 🚀

Preview Deployments by commit

Status Deployment URL Commit Updated (UTC) See this deployment's details
  • Build: Success ✅

View logs ↗
No Preview URL. Enable ↗ 2a8cdb2 2026-11-06T17:21:55.626Z View logs ↗

@codecov

codecov Bot commented Nov 6, 2026 •

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 94.13%. Comparing base (e1cbd76) to head (2a8cdb2).

Additional details and impacted files
@@           Coverage Diff           @@
##             main    #1248   +/-   ##
=======================================
  Coverage   94.13%   94.13%           
=======================================
  Files         291      291           
  Lines       28900    28900           
  Branches     2932     2932           
=======================================
  Hits        27206    27206           
  Misses       1672     1672           
  Partials       22       22           

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

🚀 New features to boost your workflow:
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

@ovflowd

ovflowd commented Nov 6, 2026

Copy link
Copy Markdown
Member Author

Requesting fast-track to fix this CI bug cc @nodejs/doc-kit

@github-actions

github-actions Bot commented Nov 6, 2026

Copy link
Copy Markdown
Contributor

api-links Generator

Performance estimate (single CI run)

  • Generation time: 3.0% faster (1.01 s → 980.00 ms)
  • Peak memory: 1.9% higher (279.02 MB → 284.24 MB)

json Generator

Performance estimate (single CI run)

  • Generation time: 17.9% faster (8.37 s → 6.87 s)
  • Peak memory: 3.3% higher (918.77 MB → 949.42 MB)

legacy-html Generator

Performance estimate (single CI run)

  • Generation time: 22.7% slower (11.08 s → 13.60 s)
  • Peak memory: 0.3% higher (1.43 GB → 1.44 GB)

legacy-json Generator

Performance estimate (single CI run)

  • Generation time: 43.8% slower (6.14 s → 8.83 s)
  • Peak memory: 3.9% lower (986.29 MB → 947.88 MB)

llms-txt Generator

Performance estimate (single CI run)

  • Generation time: 6.0% faster (8.01 s → 7.53 s)
  • Peak memory: 1.8% lower (883.55 MB → 867.91 MB)

orama-db Generator

Performance estimate (single CI run)

  • Generation time: 10.0% faster (8.39 s → 7.55 s)
  • Peak memory: 2.4% higher (1.01 GB → 1.03 GB)

web Generator

Performance estimate (single CI run)

  • Generation time: 2.6% slower (14.61 s → 14.99 s)
  • Peak memory: 3.1% higher (1.50 GB → 1.55 GB)

@ovflowd
ovflowd merged commit 9d288fe into main Nov 6, 2026
26 checks passed
@ovflowd
ovflowd deleted the meta/compare-stacked-prs branch November 6, 2026 19:25
ovflowd added a commit that referenced this pull request Nov 6, 2026
Only push runs of generate.yml upload the `commit` artifact. A PR
stacked on another PR's branch can find that PR's pull_request run for
its base commit, so prepare tried to download an artifact that run
never made, and failed. With -e push such a base finds no run, and
prepare takes the path without a comparison that #1248 added.

Assisted-by: Claude Opus 5.5 <noreply@anthropic.com>

This branch was successfully deployed

1 active deployment
Preview – api-docs-tooling — 2a8cdb20 Deployed Nov 6, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

fast track This PR can land before the typical review time, with a :+1: from collaborators

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants