build, doc: use new api doc tooling

[flakey5]

Switches over to using the new doc generation tooling. For more background on this, please see #52343

Currently a draft just to get feedback on the approach to this integration.

cc @nodejs/web-infra

---

Notable Change info (by @avivkeller):

The Node.js Website and Website Infrastructure teams have introduced a brand-new documentation pipeline, modernizing how our API docs are generated. While the documentation site may look familiar today, we are hard at work making a completely refreshed user interface in the very near future!

[nodejs-github-bot]

Review requested:

• @nodejs/nodejs-website
• @nodejs/web-infra

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 89.76%. Comparing base (9cc7fcc) to head (a2ea6f4).
⚠️ Report is 29 commits behind head on main.

Additional details and impacted files

@@            Coverage Diff             @@
##             main   #57343      +/-   ##
==========================================
+ Coverage   89.72%   89.76%   +0.04%     
==========================================
  Files         675      674       -1     
  Lines      204797   204883      +86     
  Branches    39344    39385      +41     
==========================================
+ Hits       183752   183915     +163     
+ Misses      13324    13264      -60     
+ Partials     7721     7704      -17     

see 51 files with indirect coverage changes

🚀 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.

[ovflowd]

This is the result of many months of arduous work between many awesome folks, including @flakey5 @AugustinMauroy @araujogui @ovflowd @avivkeller and others.

I'm so proud of what we are achieving here and this is a huge step towards a modern tooling and a revamped API docs within Node.js

Approving, as I believe this is ready!

[lpinca]

RSLGTM because it is hard to review and outside of my comfort zone.

[nodejs-github-bot]

CI: https://ci.nodejs.org/job/node-test-pull-request/71342/

[avivkeller]

Looks like swc (our minifier), does not support all builds, causing most of the CI failures.

cc @ovflowd @flakey5

[ovflowd]

Looks like swc (our minifier), does not support all builds, causing most of the CI failures.

cc @ovflowd @flakey5

What minifier? The HTML one?

[avivkeller]

Yes. SWC's HTML minifier doesn't have bindings for some of the more niche machines. It has the following bindings:

        "@swc/html-darwin-arm64": "1.15.11",
        "@swc/html-darwin-x64": "1.15.11",
        "@swc/html-linux-arm-gnueabihf": "1.15.11",
        "@swc/html-linux-arm64-gnu": "1.15.11",
        "@swc/html-linux-arm64-musl": "1.15.11",
        "@swc/html-linux-x64-gnu": "1.15.11",
        "@swc/html-linux-x64-musl": "1.15.11",
        "@swc/html-win32-arm64-msvc": "1.15.11",
        "@swc/html-win32-ia32-msvc": "1.15.11",
        "@swc/html-win32-x64-msvc": "1.15.11"

[ovflowd]

@Renegade334 I removed a test you added 17h ago as this test becomes irrelevant with doc-kit (it tests for that already and that's also covered (or planned to be covered, if not yet) on the new linting package for @node-core's lint pkg)

[Renegade334]

de nada 🫡

[aduh95]

this test becomes irrelevant with doc-kit (it tests for that already and that's also covered (or planned to be covered, if not yet) on the new linting package

That doesn't sound like a good reason to remove it, if it already passes why not keep it? If it doesn't, we should investigate why.

[ovflowd]

this test becomes irrelevant with doc-kit (it tests for that already and that's also covered (or planned to be covered, if not yet) on the new linting package

That doesn't sound like a good reason to remove it, if it already passes why not keep it? If it doesn't, we should investigate why.

It would have passed, the issue is that it relies on the old tooling internals, you can compare the imports. Also seems like René is fine with the removal.

[avivkeller]

This PR is ready to land once the CI is back up (and this passes)

[nodejs-github-bot]

CI: https://ci.nodejs.org/job/node-test-pull-request/71350/

[nodejs-github-bot]

CI: https://ci.nodejs.org/job/node-test-pull-request/71359/

[nodejs-github-bot]

CI: https://ci.nodejs.org/job/node-test-pull-request/71390/

[nodejs-github-bot]

CI: https://ci.nodejs.org/job/node-test-pull-request/71392/

[ovflowd]