Skip to content

Commit

Permalink
doc: mention quicker way to build docs
Browse files Browse the repository at this point in the history
`make doc-only` skips the process of building Node, which speeds
things up considerably for new contributors.

PR-URL: #52937
Reviewed-By: Antoine du Hamel <[email protected]>
Reviewed-By: Rafael Gonzaga <[email protected]>
Reviewed-By: Richard Lau <[email protected]>
Reviewed-By: Marco Ippolito <[email protected]>
Reviewed-By: Ulises Gascón <[email protected]>
Reviewed-By: James M Snell <[email protected]>
Reviewed-By: Luigi Pinca <[email protected]>
  • Loading branch information
crawford authored and targos committed May 12, 2024
1 parent ca5607b commit 9102255
Showing 1 changed file with 4 additions and 3 deletions.
7 changes: 4 additions & 3 deletions doc/contributing/api-documentation.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,9 +4,8 @@ The Node.js API documentation is generated by an in-house tooling that resides
within the [tools/doc](https://github.com/nodejs/node/tree/main/tools/doc)
directory.

The build process (using `make doc`) uses this tooling to parse the markdown
files in [doc/api](https://github.com/nodejs/node/tree/main/doc/api) and
generate the following:
The build process (using `make doc` or `make doc-only`) uses this tooling to
parse the markdown files in [`doc/api/`][] and generate the following:

1. Human-readable HTML in `out/doc/api/*.html`
2. A JSON representation in `out/doc/api/*.json`
Expand Down Expand Up @@ -302,3 +301,5 @@ mutate the data and appends it to the final JSON object.

For a more in-depth information we recommend to refer to the `json.mjs` file as
it contains a lot of comments.

[`doc/api/`]: https://github.com/nodejs/node/tree/main/doc/api

0 comments on commit 9102255

Please sign in to comment.