Skip to content

docs(turbopack): Fix all warnings in cargo doc --no-deps --workspace, and run rustdoc as part of our CI checks#91339

Open
bgw wants to merge 1 commit intocanaryfrom
bgw/fix-doc-warnings
Open

docs(turbopack): Fix all warnings in cargo doc --no-deps --workspace, and run rustdoc as part of our CI checks#91339
bgw wants to merge 1 commit intocanaryfrom
bgw/fix-doc-warnings

Conversation

@bgw
Copy link
Member

@bgw bgw commented Mar 13, 2026

This gets cargo doc clean, and enables it in CI so that we won't regress it (I'm open to removing this if it proves to be annoying).

I also cleaned up some documentation and even found some dead code (deleted turbopack/crates/turbopack-dev-server/src/source/conditional.rs).

@nextjs-bot nextjs-bot added created-by: Turbopack team PRs by the Turbopack team. Turbopack Related to Turbopack with Next.js. type: next labels Mar 13, 2026
Copy link
Member Author

bgw commented Mar 13, 2026

@bgw bgw requested review from a team and lukesandberg March 13, 2026 20:30
"cache-build-native": "[ -d native ] && echo $(ls native)",
"rust-check-fmt": "cd ../..; cargo fmt -- --check",
"rust-check-clippy": "cargo clippy --workspace --all-targets -- -D warnings -A deprecated",
"rust-check-doc": "RUSTDOCFLAGS='-Zunstable-options --output-format=json' cargo doc --no-deps --workspace",
Copy link
Member Author

Choose a reason for hiding this comment

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

--output-format=json is faster than the default html formatter, and we only care about getting the warnings in this case.

@bgw bgw marked this pull request as ready for review March 13, 2026 20:35
@nextjs-bot
Copy link
Collaborator

nextjs-bot commented Mar 13, 2026

Tests Passed

@codspeed-hq
Copy link

codspeed-hq bot commented Mar 13, 2026

Merging this PR will not alter performance

✅ 17 untouched benchmarks
⏩ 3 skipped benchmarks1


Comparing bgw/fix-doc-warnings (d25a353) with canary (68dade4)

Open in CodSpeed

Footnotes

  1. 3 benchmarks were skipped, so the baseline results were used instead. If they were deleted from the codebase, click here and archive them to remove them from the performance reports.

@bgw bgw force-pushed the bgw/fix-doc-warnings branch from 1181fe3 to d25a353 Compare March 14, 2026 00:29
@nextjs-bot
Copy link
Collaborator

Stats from current PR

✅ No significant changes detected

📊 All Metrics
📖 Metrics Glossary

Dev Server Metrics:

  • Listen = TCP port starts accepting connections
  • First Request = HTTP server returns successful response
  • Cold = Fresh build (no cache)
  • Warm = With cached build artifacts

Build Metrics:

  • Fresh = Clean build (no .next directory)
  • Cached = With existing .next directory

Change Thresholds:

  • Time: Changes < 50ms AND < 10%, OR < 2% are insignificant
  • Size: Changes < 1KB AND < 1% are insignificant
  • All other changes are flagged to catch regressions

⚡ Dev Server

Metric Canary PR Change Trend
Cold (Listen) 455ms 456ms ▁▁█▁▁
Cold (Ready in log) 438ms 437ms ▁▁█▁▁
Cold (First Request) 1.238s 1.217s ▁▃█▁▃
Warm (Listen) 456ms 457ms ▁▁█▁▁
Warm (Ready in log) 442ms 446ms ▁▁█▁▁
Warm (First Request) 347ms 355ms ▁▁█▁▁
📦 Dev Server (Webpack) (Legacy)

📦 Dev Server (Webpack)

Metric Canary PR Change Trend
Cold (Listen) 456ms 455ms ▁▁▁▁▁
Cold (Ready in log) 439ms 438ms ▃▃▃▃▃
Cold (First Request) 1.943s 1.953s ▂▂▁▂▂
Warm (Listen) 456ms 456ms ▁▁▁▁▁
Warm (Ready in log) 439ms 438ms ▃▃▃▃▃
Warm (First Request) 1.963s 1.938s ▂▂▁▂▂

⚡ Production Builds

Metric Canary PR Change Trend
Fresh Build 3.890s 3.848s ▂▁█▂▁
Cached Build 3.925s 3.841s ▂▁█▁▁
📦 Production Builds (Webpack) (Legacy)

📦 Production Builds (Webpack)

Metric Canary PR Change Trend
Fresh Build 14.321s 14.326s ▁▁▁▁▁
Cached Build 14.371s 14.421s ▁▁▁▁▁
node_modules Size 482 MB 482 MB ▁▁▁▁▁
📦 Bundle Sizes

Bundle Sizes

⚡ Turbopack

Client

Main Bundles
Canary PR Change
0_6xxv2jiaklh.js gzip 13.6 kB N/A -
0.-r71sd1j_zb.js gzip 7.61 kB N/A -
0~lwfcrlb4v_9.css gzip 115 B 115 B
00h0nz7r436~l.js gzip 13.3 kB N/A -
02ku7edzc_wf7.js gzip 450 B N/A -
03~yq9q893hmn.js gzip 39.4 kB 39.4 kB
03kfigr~tki9k.js gzip 153 B N/A -
06fjs~acvcipw.js gzip 155 B N/A -
07sn0b4nbcn1d.js gzip 48 kB N/A -
07yamol04-7he.js gzip 158 B N/A -
082o1b6e4cgsl.js gzip 162 B N/A -
092lcb3fqrrf9.js gzip 8.52 kB N/A -
0aj~xs1l1g8tg.js gzip 8.53 kB N/A -
0dljykshdtp~7.js gzip 154 B N/A -
0e0fjxi5x2ovt.js gzip 152 B N/A -
0gx~e1o3o_.dp.js gzip 156 B N/A -
0h35gmp9u328z.js gzip 8.54 kB N/A -
0h6fkavebp.iz.js gzip 8.47 kB N/A -
0ino_yf1k3h6k.js gzip 10.4 kB N/A -
0k.sixc712dq1.js gzip 10.1 kB N/A -
0kkm7tesfinr6.js gzip 12.9 kB N/A -
0moy~uao4dl.m.js gzip 9.19 kB N/A -
0n1xzocv_dmxu.js gzip 65.7 kB N/A -
0q50rtpusjy90.js gzip 2.28 kB N/A -
0smgy2grrrlka.js gzip 8.58 kB N/A -
0srvny17kd5qf.js gzip 161 B N/A -
0t1dzhdfh0txh.js gzip 215 B 215 B
0x_2nfhowr8pf.js gzip 169 B N/A -
0zid7o0-vupvp.js gzip 225 B N/A -
0znet827k2qvd.js gzip 156 B N/A -
1013-q1.~kmsp.js gzip 156 B N/A -
11yo3xfd6b147.js gzip 12.9 kB N/A -
13.84hqxl_1p7.js gzip 9.76 kB N/A -
1554wr-t7p6z-.js gzip 8.55 kB N/A -
158h_tezj46ng.js gzip 70.8 kB N/A -
15tjst79~qy3_.js gzip 1.46 kB N/A -
15z_v00ne4ud0.js gzip 8.47 kB N/A -
160~3n3z.rtcg.js gzip 156 B N/A -
17d_m3p4j9w6r.js gzip 5.62 kB N/A -
17yu~3yiu7d2m.js gzip 8.52 kB N/A -
189pta_o9070_.js gzip 156 B N/A -
turbopack-0-.._2ck.js gzip 4.16 kB N/A -
turbopack-00..0-ng.js gzip 4.17 kB N/A -
turbopack-04...n1h.js gzip 4.16 kB N/A -
turbopack-05..genk.js gzip 4.16 kB N/A -
turbopack-0a..oj61.js gzip 4.16 kB N/A -
turbopack-0f..1wp4.js gzip 4.15 kB N/A -
turbopack-0f..pko_.js gzip 4.15 kB N/A -
turbopack-0j..9wmf.js gzip 4.16 kB N/A -
turbopack-0q..a_70.js gzip 4.16 kB N/A -
turbopack-0s..5z.w.js gzip 4.16 kB N/A -
turbopack-0x..bgal.js gzip 4.16 kB N/A -
turbopack-0x..dq1_.js gzip 4.16 kB N/A -
turbopack-17..6t3t.js gzip 4.14 kB N/A -
turbopack-17..bgbq.js gzip 4.16 kB N/A -
0_~83b5e6e7l0.js gzip N/A 13.6 kB -
0~8z_sx_iaue1.js gzip N/A 156 B -
00_yiead245-g.js gzip N/A 154 B -
00qxokmb8l1i9.js gzip N/A 155 B -
01-jagslnpmfq.js gzip N/A 156 B -
02s0ipraqc1x4.js gzip N/A 65.7 kB -
03t__~.5lvgeu.js gzip N/A 5.62 kB -
04d6ll75jqx3r.js gzip N/A 9.19 kB -
0583exyh-yhc7.js gzip N/A 9.76 kB -
05b07nana~4_..js gzip N/A 10.1 kB -
072lv63r8dcz~.js gzip N/A 8.58 kB -
07ywrka~ab742.js gzip N/A 156 B -
0ar1~bwpezfgw.js gzip N/A 13.3 kB -
0bhrcv3zhgglb.js gzip N/A 160 B -
0c99mq1ez2bke.js gzip N/A 450 B -
0cq-cmde_ws6u.js gzip N/A 8.47 kB -
0fwf102w10o9~.js gzip N/A 8.52 kB -
0gtmn.q_j1v5r.js gzip N/A 10.4 kB -
0jhtb~3297y0u.js gzip N/A 48 kB -
0l4d~z7ixj3wz.js gzip N/A 12.9 kB -
0nclq9z6yzzm5.js gzip N/A 1.46 kB -
0nzumcogektg7.js gzip N/A 8.55 kB -
0p_~2lgjn3rkr.js gzip N/A 152 B -
0s.c-cn5eebrx.js gzip N/A 8.47 kB -
0tna7lg6q4zne.js gzip N/A 12.9 kB -
0tzsv~9ki.9x-.js gzip N/A 155 B -
0votdfxr5fb5u.js gzip N/A 2.28 kB -
0w_00kd57iuc2.js gzip N/A 169 B -
0xdtms9j1~acv.js gzip N/A 70.8 kB -
0xkuhv202qqhu.js gzip N/A 7.6 kB -
0ykl9bs_qj.5..js gzip N/A 8.52 kB -
0zfen0tnxp4gh.js gzip N/A 8.55 kB -
10wkq1h9jzkg..js gzip N/A 225 B -
12_65ixdzlrxl.js gzip N/A 162 B -
125qkkx49dylx.js gzip N/A 157 B -
149ndfh8zfcaz.js gzip N/A 8.53 kB -
16v~mw514qk0b.js gzip N/A 156 B -
18dr1phwfsppg.js gzip N/A 156 B -
turbopack-0~..1_ap.js gzip N/A 4.16 kB -
turbopack-0~..xb1m.js gzip N/A 4.14 kB -
turbopack-01..c5.4.js gzip N/A 4.16 kB -
turbopack-0a..c58v.js gzip N/A 4.16 kB -
turbopack-0h..7yh4.js gzip N/A 4.16 kB -
turbopack-0j..hys9.js gzip N/A 4.16 kB -
turbopack-0m.._2sh.js gzip N/A 4.16 kB -
turbopack-0o..-33n.js gzip N/A 4.16 kB -
turbopack-0q..dg5m.js gzip N/A 4.18 kB -
turbopack-0r..2bnq.js gzip N/A 4.16 kB -
turbopack-0s..s1ev.js gzip N/A 4.16 kB -
turbopack-0w..x33d.js gzip N/A 4.16 kB -
turbopack-0x..bdqz.js gzip N/A 4.16 kB -
turbopack-0y..eyz3.js gzip N/A 4.16 kB -
Total 462 kB 462 kB ⚠️ +25 B

Server

Middleware
Canary PR Change
middleware-b..fest.js gzip 714 B 708 B
Total 714 B 708 B ✅ -6 B
Build Details
Build Manifests
Canary PR Change
_buildManifest.js gzip 431 B 430 B
Total 431 B 430 B ✅ -1 B

📦 Webpack

Client

Main Bundles
Canary PR Change
5528-HASH.js gzip 5.54 kB N/A -
6280-HASH.js gzip 59.9 kB N/A -
6335.HASH.js gzip 169 B N/A -
912-HASH.js gzip 4.59 kB N/A -
e8aec2e4-HASH.js gzip 62.7 kB N/A -
framework-HASH.js gzip 59.7 kB 59.7 kB
main-app-HASH.js gzip 256 B 254 B
main-HASH.js gzip 39.2 kB 39.2 kB
webpack-HASH.js gzip 1.68 kB 1.68 kB
262-HASH.js gzip N/A 4.59 kB -
2889.HASH.js gzip N/A 169 B -
5602-HASH.js gzip N/A 5.55 kB -
6948ada0-HASH.js gzip N/A 62.7 kB -
9544-HASH.js gzip N/A 60.6 kB -
Total 234 kB 235 kB ⚠️ +721 B
Polyfills
Canary PR Change
polyfills-HASH.js gzip 39.4 kB 39.4 kB
Total 39.4 kB 39.4 kB
Pages
Canary PR Change
_app-HASH.js gzip 194 B 194 B
_error-HASH.js gzip 183 B 180 B 🟢 3 B (-2%)
css-HASH.js gzip 331 B 330 B
dynamic-HASH.js gzip 1.81 kB 1.81 kB
edge-ssr-HASH.js gzip 256 B 256 B
head-HASH.js gzip 351 B 352 B
hooks-HASH.js gzip 384 B 383 B
image-HASH.js gzip 580 B 581 B
index-HASH.js gzip 260 B 260 B
link-HASH.js gzip 2.51 kB 2.51 kB
routerDirect..HASH.js gzip 320 B 319 B
script-HASH.js gzip 386 B 386 B
withRouter-HASH.js gzip 315 B 315 B
1afbb74e6ecf..834.css gzip 106 B 106 B
Total 7.98 kB 7.98 kB ✅ -1 B

Server

Edge SSR
Canary PR Change
edge-ssr.js gzip 125 kB 125 kB
page.js gzip 267 kB 267 kB
Total 392 kB 392 kB ✅ -242 B
Middleware
Canary PR Change
middleware-b..fest.js gzip 615 B 615 B
middleware-r..fest.js gzip 156 B 155 B
middleware.js gzip 43.6 kB 43.7 kB
edge-runtime..pack.js gzip 842 B 842 B
Total 45.3 kB 45.3 kB ⚠️ +78 B
Build Details
Build Manifests
Canary PR Change
_buildManifest.js gzip 715 B 718 B
Total 715 B 718 B ⚠️ +3 B
Build Cache
Canary PR Change
0.pack gzip 4.24 MB 4.23 MB 🟢 7.51 kB (0%)
index.pack gzip 109 kB 109 kB
index.pack.old gzip 109 kB 108 kB
Total 4.46 MB 4.45 MB ✅ -8.61 kB

🔄 Shared (bundler-independent)

Runtimes
Canary PR Change
app-page-exp...dev.js gzip 332 kB 332 kB
app-page-exp..prod.js gzip 180 kB 180 kB
app-page-tur...dev.js gzip 332 kB 332 kB
app-page-tur..prod.js gzip 180 kB 180 kB
app-page-tur...dev.js gzip 328 kB 328 kB
app-page-tur..prod.js gzip 178 kB 178 kB
app-page.run...dev.js gzip 329 kB 329 kB
app-page.run..prod.js gzip 178 kB 178 kB
app-route-ex...dev.js gzip 76 kB 76 kB
app-route-ex..prod.js gzip 51.7 kB 51.7 kB
app-route-tu...dev.js gzip 76 kB 76 kB
app-route-tu..prod.js gzip 51.7 kB 51.7 kB
app-route-tu...dev.js gzip 75.6 kB 75.6 kB
app-route-tu..prod.js gzip 51.5 kB 51.5 kB
app-route.ru...dev.js gzip 75.5 kB 75.5 kB
app-route.ru..prod.js gzip 51.4 kB 51.4 kB
dist_client_...dev.js gzip 324 B 324 B
dist_client_...dev.js gzip 326 B 326 B
dist_client_...dev.js gzip 318 B 318 B
dist_client_...dev.js gzip 317 B 317 B
pages-api-tu...dev.js gzip 43.3 kB 43.3 kB
pages-api-tu..prod.js gzip 33 kB 33 kB
pages-api.ru...dev.js gzip 43.3 kB 43.3 kB
pages-api.ru..prod.js gzip 33 kB 33 kB
pages-turbo....dev.js gzip 52.7 kB 52.7 kB
pages-turbo...prod.js gzip 38.6 kB 38.6 kB
pages.runtim...dev.js gzip 52.7 kB 52.7 kB
pages.runtim..prod.js gzip 38.6 kB 38.6 kB
server.runti..prod.js gzip 62.4 kB 62.4 kB
Total 2.95 MB 2.95 MB ⚠️ +1 B
📎 Tarball URL
https://vercel-packages.vercel.app/next/commits/d25a3537000527f2aa71264ed191c366d94820e0/next

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

Labels

created-by: Turbopack team PRs by the Turbopack team. Turbopack Related to Turbopack with Next.js. type: next

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants