Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Appearance settings

Commit 273607e

Browse filesBrowse files
dario-piotrowiczaduh95
authored andcommitted
doc: add new writing-docs contributing md
PR-URL: #57502 Reviewed-By: James M Snell <jasnell@gmail.com> Reviewed-By: Yagiz Nizipli <yagiz@nizipli.com>
1 parent 1f08864 commit 273607e
Copy full SHA for 273607e

File tree

Expand file treeCollapse file tree

1 file changed

+38
-0
lines changed
Open diff view settings
Filter options
Expand file treeCollapse file tree

1 file changed

+38
-0
lines changed
Open diff view settings
Collapse file

‎doc/contributing/writing-docs.md‎

Copy file name to clipboard
+38Lines changed: 38 additions & 0 deletions
  • Display the source diff
  • Display the rich diff
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,38 @@
1+
# How to write documentation for the Node.js project
2+
3+
This document refers to the Node.js API documentation that gets deployed to [nodejs.org/en/doc][]
4+
and consists in a general reference on how to write and update such documentation.
5+
6+
## Style Guide
7+
8+
For a style guide on how to write or update the Node.js documentation refer to the [doc/README][] document.
9+
10+
## Building
11+
12+
There are a few different commands that you can use to build and view the documentation locally,
13+
the simplest one being:
14+
15+
```bash
16+
make docserve
17+
```
18+
19+
This command builds the documentation, spins up a local server and provides you with a URL to
20+
it that you can navigate to in order to view the built documentation.
21+
22+
For more build options refer to the [documentation building][building-the-documentation] documentation.
23+
24+
And for more details about the tooling used to build the documentation refer to
25+
the [API Documentation Tooling][] document.
26+
27+
## Linting and Formatting
28+
29+
To make sure that your changes pass linting run the following command:
30+
31+
```bash
32+
make lint-md
33+
```
34+
35+
[API Documentation Tooling]: ./api-documentation.md
36+
[building-the-documentation]: ../../BUILDING.md#building-the-documentation
37+
[doc/README]: ../../doc/README.md
38+
[nodejs.org/en/doc]: https://nodejs.org/en/docs/

0 commit comments

Comments
0 (0)
Morty Proxy This is a proxified and sanitized view of the page, visit original site.