Skip to content
This repository was archived by the owner on Mar 21, 2023. It is now read-only.
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
126 commits
Select commit Hold shift + click to select a range
5531d1e
New translations releases.md (English)
Mr7Gabriel Jul 18, 2022
aca5e42
New translations trademark.md (English, Indonesia)
Mr7Gabriel Jul 18, 2022
6765619
New translations resources.md (English, Indonesia)
Mr7Gabriel Jul 18, 2022
3238cb7
New translations index.md (English, Indonesia)
Mr7Gabriel Jul 18, 2022
38872f6
New translations governance.md (English, Indonesia)
Mr7Gabriel Jul 18, 2022
503e8c8
New translations nodejs-docker-webapp.md (English)
Mr7Gabriel Jul 18, 2022
7d7a3a0
New translations event-loop-timers-and-nexttick.md (English)
Mr7Gabriel Jul 18, 2022
b26ee3b
New translations getting-started-guide.md (English)
Mr7Gabriel Jul 18, 2022
1af4330
New translations timers-in-node.md (English, Indonesia)
Mr7Gabriel Jul 18, 2022
9f21131
New translations publishing-napi-modules.md (English)
Mr7Gabriel Jul 18, 2022
8e1dfbc
New translations simple-profiling.md (English)
Mr7Gabriel Jul 18, 2022
a561697
New translations dont-block-the-event-loop.md (English)
Mr7Gabriel Jul 18, 2022
c7051e7
New translations working-with-different-filesystems.md (English)
Mr7Gabriel Jul 18, 2022
1e6b090
New translations buffer-constructor-deprecation.md (English, Indonesia)
Mr7Gabriel Jul 18, 2022
07bd1c4
New translations domain-postmortem.md (English, Indonesia)
Mr7Gabriel Jul 18, 2022
0b4c70c
New translations backpressuring-in-streams.md (English)
Mr7Gabriel Jul 18, 2022
0cc3c87
New translations working-groups.md (English)
Mr7Gabriel Jul 18, 2022
b76064c
New translations abi-stability.md (English)
Mr7Gabriel Jul 18, 2022
d3b4634
New translations anatomy-of-an-http-transaction.md (English)
Mr7Gabriel Jul 18, 2022
329bdd1
New translations blocking-vs-non-blocking.md (English)
Mr7Gabriel Jul 18, 2022
1bb4412
New translations debugging-getting-started.md (English)
Mr7Gabriel Jul 18, 2022
dab640c
New translations diagnostics-flamegraph.md (English)
Mr7Gabriel Jul 18, 2022
c61be03
New translations dependencies.md (English)
Mr7Gabriel Jul 18, 2022
015d748
New translations how-to-create-a-custom-repl.md (English)
Mr7Gabriel Jul 18, 2022
2d4bb86
New translations how-to-use-nodejs-repl.md (English)
Mr7Gabriel Jul 18, 2022
8f5b18b
New translations current.md (English)
Mr7Gabriel Jul 18, 2022
ee9f2f0
New translations index.md (English)
Mr7Gabriel Jul 18, 2022
739044a
New translations package-manager.md (English)
Mr7Gabriel Jul 18, 2022
8cc70c2
New translations collab-summit.md (English)
Mr7Gabriel Jul 18, 2022
65664f6
New translations node-meetups.md (English)
Mr7Gabriel Jul 18, 2022
5d7efa0
New translations how-to-use-crypto-module.md (English)
Mr7Gabriel Jul 18, 2022
5509edb
New translations introduction.md (English)
Mr7Gabriel Jul 18, 2022
a58399f
New translations the-console-module.md (English)
Mr7Gabriel Jul 18, 2022
7995098
New translations what-is-json.md (English, Indonesia)
Mr7Gabriel Jul 18, 2022
01296cb
New translations site.json (English)
Mr7Gabriel Jul 18, 2022
36b05c5
New translations black-lives-matter.md (English, Indonesia)
Mr7Gabriel Jul 18, 2022
f42be8e
New translations what-is-the-arguments-object.md (English, Indonesia)
Mr7Gabriel Jul 18, 2022
7816340
New translations 404.md (Indonesian)
Mr7Gabriel Jul 20, 2022
d07f6a4
New translations contribute.md (Indonesian)
Mr7Gabriel Jul 20, 2022
5142580
New translations working-with-different-filesystems.md (Indonesian)
Mr7Gabriel Jul 20, 2022
b9c9571
New translations index.md (Indonesian)
Mr7Gabriel Jul 20, 2022
f2f64c0
New translations dependencies.md (Indonesian)
Mr7Gabriel Jul 20, 2022
73f8e5e
New translations current.md (Indonesian)
Mr7Gabriel Jul 20, 2022
605298f
New translations index.md (Indonesian)
Mr7Gabriel Jul 20, 2022
3480639
New translations package-manager.md (Indonesian)
Mr7Gabriel Jul 20, 2022
e45dc03
New translations releases.md (Indonesian)
Mr7Gabriel Jul 20, 2022
bed793d
New translations code-and-learn.md (Indonesian)
Mr7Gabriel Jul 20, 2022
efa907a
New translations collab-summit.md (Indonesian)
Mr7Gabriel Jul 20, 2022
48920f6
New translations index.md (Indonesian)
Mr7Gabriel Jul 20, 2022
cfa78c6
New translations community.md (Indonesian)
Mr7Gabriel Jul 20, 2022
19f7ecb
New translations node-meetups.md (Indonesian)
Mr7Gabriel Jul 20, 2022
3d67044
New translations index.md (Indonesian)
Mr7Gabriel Jul 20, 2022
1fa63e7
New translations how-to-access-query-string-parameters.md (Indonesian)
Mr7Gabriel Jul 20, 2022
3d6c44e
New translations how-to-create-a-HTTP-request.md (Indonesian)
Mr7Gabriel Jul 20, 2022
e0d325b
New translations how-to-create-a-HTTP-server.md (Indonesian)
Mr7Gabriel Jul 20, 2022
5945987
New translations how-to-create-a-HTTPS-server.md (Indonesian)
Mr7Gabriel Jul 20, 2022
05e5e9a
New translations how-to-handle-multipart-form-data.md (Indonesian)
Mr7Gabriel Jul 20, 2022
b39d5f2
New translations how-to-read-POST-data.md (Indonesian)
Mr7Gabriel Jul 20, 2022
eca0d22
New translations how-to-serve-static-files.md (Indonesian)
Mr7Gabriel Jul 20, 2022
0b9667a
New translations timers-in-node.md (Indonesian)
Mr7Gabriel Jul 20, 2022
239543c
New translations simple-profiling.md (Indonesian)
Mr7Gabriel Jul 20, 2022
d0bc401
New translations publishing-napi-modules.md (Indonesian)
Mr7Gabriel Jul 20, 2022
3da289c
New translations nodejs-docker-webapp.md (Indonesian)
Mr7Gabriel Jul 20, 2022
e8bcce4
New translations governance.md (Indonesian)
Mr7Gabriel Jul 20, 2022
6549c19
New translations index.md (Indonesian)
Mr7Gabriel Jul 20, 2022
7592c4c
New translations privacy.md (Indonesian)
Mr7Gabriel Jul 20, 2022
6d216ba
New translations releases.md (Indonesian)
Mr7Gabriel Jul 20, 2022
1a65221
New translations resources.md (Indonesian)
Mr7Gabriel Jul 20, 2022
b67087d
New translations trademark.md (Indonesian)
Mr7Gabriel Jul 20, 2022
448e78c
New translations working-groups.md (Indonesian)
Mr7Gabriel Jul 20, 2022
9cf9a38
New translations black-lives-matter.md (Indonesian)
Mr7Gabriel Jul 20, 2022
876707a
New translations es6.md (Indonesian)
Mr7Gabriel Jul 20, 2022
6e4b0e8
New translations abi-stability.md (Indonesian)
Mr7Gabriel Jul 20, 2022
23dd36d
New translations anatomy-of-an-http-transaction.md (Indonesian)
Mr7Gabriel Jul 20, 2022
39de596
New translations backpressuring-in-streams.md (Indonesian)
Mr7Gabriel Jul 20, 2022
4a6206c
New translations blocking-vs-non-blocking.md (Indonesian)
Mr7Gabriel Jul 20, 2022
c45c3cc
New translations buffer-constructor-deprecation.md (Indonesian)
Mr7Gabriel Jul 20, 2022
f39643a
New translations debugging-getting-started.md (Indonesian)
Mr7Gabriel Jul 20, 2022
5cd4bf9
New translations diagnostics-flamegraph.md (Indonesian)
Mr7Gabriel Jul 20, 2022
a806801
New translations domain-postmortem.md (Indonesian)
Mr7Gabriel Jul 20, 2022
57ef2a3
New translations dont-block-the-event-loop.md (Indonesian)
Mr7Gabriel Jul 20, 2022
58095aa
New translations event-loop-timers-and-nexttick.md (Indonesian)
Mr7Gabriel Jul 20, 2022
09eb722
New translations getting-started-guide.md (Indonesian)
Mr7Gabriel Jul 20, 2022
e8d3728
New translations index.md (Indonesian)
Mr7Gabriel Jul 20, 2022
f74d9e5
New translations how-to-create-a-custom-repl.md (Indonesian)
Mr7Gabriel Jul 20, 2022
8236059
New translations how-to-use-nodejs-repl.md (Indonesian)
Mr7Gabriel Jul 20, 2022
f4dbb42
New translations how-to-use-buffers.md (Indonesian)
Mr7Gabriel Jul 20, 2022
b361240
New translations how-to-use-fs-create-read-stream.md (Indonesian)
Mr7Gabriel Jul 20, 2022
f22ae60
New translations the-process-module.md (Indonesian)
Mr7Gabriel Jul 20, 2022
d980858
New translations globals-in-node-js.md (Indonesian)
Mr7Gabriel Jul 20, 2022
da9485b
New translations how-to-debug-nodejs-applications.md (Indonesian)
Mr7Gabriel Jul 20, 2022
0d77e2c
New translations how-to-use-util-inspect.md (Indonesian)
Mr7Gabriel Jul 20, 2022
52ada4d
New translations how-to-access-module-package-info.md (Indonesian)
Mr7Gabriel Jul 20, 2022
045c33a
New translations what-is-npm.md (Indonesian)
Mr7Gabriel Jul 20, 2022
e978874
New translations what-is-the-file-package-json.md (Indonesian)
Mr7Gabriel Jul 20, 2022
66cd1a6
New translations the-console-module.md (Indonesian)
Mr7Gabriel Jul 20, 2022
d749bd7
New translations what-is-node-core-verus-userland.md (Indonesian)
Mr7Gabriel Jul 20, 2022
af39a0b
New translations what-are-callbacks.md (Indonesian)
Mr7Gabriel Jul 20, 2022
9c4ccf3
New translations what-is-require.md (Indonesian)
Mr7Gabriel Jul 20, 2022
974fce9
New translations index.md (Indonesian)
Mr7Gabriel Jul 20, 2022
d07a503
New translations how-to-create-default-parameters-for-functions.md (I…
Mr7Gabriel Jul 20, 2022
ee82ee0
New translations using-ECMA5-in-nodejs.md (Indonesian)
Mr7Gabriel Jul 20, 2022
07e4630
New translations what-are-the-built-in-timer-functions.md (Indonesian)
Mr7Gabriel Jul 20, 2022
7ae2956
New translations what-is-json.md (Indonesian)
Mr7Gabriel Jul 20, 2022
1e3e773
New translations what-is-the-arguments-object.md (Indonesian)
Mr7Gabriel Jul 20, 2022
a9c6d8c
New translations what-are-event-emitters.md (Indonesian)
Mr7Gabriel Jul 20, 2022
28f1062
New translations how-to-write-asynchronous-code.md (Indonesian)
Mr7Gabriel Jul 20, 2022
5cca7f4
New translations how-to-use-fs-create-write-stream.md (Indonesian)
Mr7Gabriel Jul 20, 2022
59f15db
New translations how-to-use-the-tls-module.md (Indonesian)
Mr7Gabriel Jul 20, 2022
1edda4f
New translations how-to-use-stream-pipe.md (Indonesian)
Mr7Gabriel Jul 20, 2022
c9dda6e
New translations what-are-streams.md (Indonesian)
Mr7Gabriel Jul 20, 2022
cc60bda
New translations how-to-spawn-a-child-process.md (Indonesian)
Mr7Gabriel Jul 20, 2022
a940ea0
New translations how-to-get-colors-on-the-command-line.md (Indonesian)
Mr7Gabriel Jul 20, 2022
d9f9a6f
New translations how-to-parse-command-line-arguments.md (Indonesian)
Mr7Gabriel Jul 20, 2022
f59093f
New translations how-to-prompt-for-command-line-input.md (Indonesian)
Mr7Gabriel Jul 20, 2022
4ed6cd1
New translations how-to-use-crypto-module.md (Indonesian)
Mr7Gabriel Jul 20, 2022
bfac671
New translations what-are-the-error-conventions.md (Indonesian)
Mr7Gabriel Jul 20, 2022
03fe80e
New translations introduction.md (Indonesian)
Mr7Gabriel Jul 20, 2022
7fe1423
New translations what-is-the-error-object.md (Indonesian)
Mr7Gabriel Jul 20, 2022
9fff803
New translations what-is-try-catch.md (Indonesian)
Mr7Gabriel Jul 20, 2022
02cbe60
New translations how-to-read-files-in-nodejs.md (Indonesian)
Mr7Gabriel Jul 20, 2022
38f9c99
New translations how-to-search-files-and-directories-in-nodejs.md (In…
Mr7Gabriel Jul 20, 2022
890de1a
New translations how-to-store-local-config-data.md (Indonesian)
Mr7Gabriel Jul 20, 2022
e45a7e8
New translations how-to-use-the-path-module.md (Indonesian)
Mr7Gabriel Jul 20, 2022
e80d4f4
New translations how-to-write-files-in-nodejs.md (Indonesian)
Mr7Gabriel Jul 20, 2022
9a7fdfb
New translations site.json (Indonesian)
Mr7Gabriel Jul 20, 2022
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 3 additions & 9 deletions locale/en/about/governance.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,23 +11,17 @@ The Node.js project follows a [Consensus Seeking][] decision making model.

## Collaborators

The [nodejs/node][] core GitHub repository is maintained by the Collaborators
who are added by the Technical Steering Committee ([TSC][]) on an ongoing basis.
The [nodejs/node][] core GitHub repository is maintained by the Collaborators who are added by the Technical Steering Committee ([TSC][]) on an ongoing basis.

Individuals making significant and valuable contributions are made Collaborators
and given commit-access to the project. These individuals are identified by the
TSC and their nomination is discussed with the existing Collaborators.
Individuals making significant and valuable contributions are made Collaborators and given commit-access to the project. These individuals are identified by the TSC and their nomination is discussed with the existing Collaborators.

For the current list of Collaborators, see the project's [README.md][].

A guide for Collaborators is maintained at [collaborator-guide.md][].

## Top Level Committees

The project is governed jointly by the [Technical Steering Committee (TSC)][]
which is responsible for high-level guidance of the project, and the
[Community Committee (CommComm)][] which is responsible for guiding and
extending the Node.js community.
The project is governed jointly by the [Technical Steering Committee (TSC)][] which is responsible for high-level guidance of the project, and the [Community Committee (CommComm)][] which is responsible for guiding and extending the Node.js community.

[collaborator-guide.md]: https://github.com/nodejs/node/blob/master/doc/guides/collaborator-guide.md
[Community Committee (CommComm)]: https://github.com/nodejs/community-committee/blob/master/Community-Committee-Charter.md
Expand Down
37 changes: 6 additions & 31 deletions locale/en/about/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,10 +6,7 @@ trademark: Trademark

# About Node.js®

As an asynchronous event-driven JavaScript runtime, Node.js is designed to build
scalable network applications. In the following "hello world" example, many
connections can be handled concurrently. Upon each connection, the callback is
fired, but if there is no work to be done, Node.js will sleep.
As an asynchronous event-driven JavaScript runtime, Node.js is designed to build scalable network applications. In the following "hello world" example, many connections can be handled concurrently. Upon each connection, the callback is fired, but if there is no work to be done, Node.js will sleep.

```javascript
const http = require('http');
Expand All @@ -28,39 +25,17 @@ server.listen(port, hostname, () => {
});
```

This is in contrast to today's more common concurrency model, in which OS threads
are employed. Thread-based networking is relatively inefficient and very
difficult to use. Furthermore, users of Node.js are free from worries of
dead-locking the process, since there are no locks. Almost no function in
Node.js directly performs I/O, so the process never blocks except when the I/O is performed using
synchronous methods of Node.js standard library. Because nothing blocks, scalable systems are very
reasonable to develop in Node.js.
This is in contrast to today's more common concurrency model, in which OS threads are employed. Thread-based networking is relatively inefficient and very difficult to use. Furthermore, users of Node.js are free from worries of dead-locking the process, since there are no locks. Almost no function in Node.js directly performs I/O, so the process never blocks except when the I/O is performed using synchronous methods of Node.js standard library. Because nothing blocks, scalable systems are very reasonable to develop in Node.js.

If some of this language is unfamiliar, there is a full article on
[Blocking vs. Non-Blocking][].
If some of this language is unfamiliar, there is a full article on [Blocking vs. Non-Blocking][].

---

Node.js is similar in design to, and influenced by, systems like Ruby's
[Event Machine][] and Python's [Twisted][]. Node.js takes the event model a bit
further. It presents an [event loop][] as a runtime construct instead of as a library. In other systems,
there is always a blocking call to start the event-loop.
Typically, behavior is defined through callbacks at the beginning of a script, and
at the end a server is started through a blocking call like `EventMachine::run()`.
In Node.js, there is no such start-the-event-loop call. Node.js simply enters the event loop after executing the input script. Node.js
exits the event loop when there are no more callbacks to perform. This behavior
is like browser JavaScript — the event loop is hidden from the user.
Node.js is similar in design to, and influenced by, systems like Ruby's [Event Machine][] and Python's [Twisted][]. Node.js takes the event model a bit further. It presents an [event loop][] as a runtime construct instead of as a library. In other systems, there is always a blocking call to start the event-loop. Typically, behavior is defined through callbacks at the beginning of a script, and at the end a server is started through a blocking call like `EventMachine::run()`. In Node.js, there is no such start-the-event-loop call. Node.js simply enters the event loop after executing the input script. Node.js exits the event loop when there are no more callbacks to perform. This behavior is like browser JavaScript — the event loop is hidden from the user.

HTTP is a first-class citizen in Node.js, designed with streaming and low
latency in mind. This makes Node.js well suited for the foundation of a web
library or framework.
HTTP is a first-class citizen in Node.js, designed with streaming and low latency in mind. This makes Node.js well suited for the foundation of a web library or framework.

Node.js being designed without threads doesn't mean you can't take
advantage of multiple cores in your environment. Child processes can be spawned
by using our [`child_process.fork()`][] API, and are designed to be easy to
communicate with. Built upon that same interface is the [`cluster`][] module,
which allows you to share sockets between processes to enable load balancing
over your cores.
Node.js being designed without threads doesn't mean you can't take advantage of multiple cores in your environment. Child processes can be spawned by using our [`child_process.fork()`][] API, and are designed to be easy to communicate with. Built upon that same interface is the [`cluster`][] module, which allows you to share sockets between processes to enable load balancing over your cores.

[Blocking vs. Non-Blocking]: /en/docs/guides/blocking-vs-non-blocking/
[`child_process.fork()`]: https://nodejs.org/api/child_process.html#child_process_child_process_fork_modulepath_args_options
Expand Down
5 changes: 1 addition & 4 deletions locale/en/about/releases.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,7 +19,4 @@ schedule-footer: Dates are subject to change.

# Releases

Major Node.js versions enter _Current_ release status for six months, which gives library authors time to add support for them.
After six months, odd-numbered releases (9, 11, etc.) become unsupported, and even-numbered releases (10, 12, etc.) move to _Active LTS_ status and are ready for general use.
_LTS_ release status is "long-term support", which typically guarantees that critical bugs will be fixed for a total of 30 months.
Production applications should only use _Active LTS_ or _Maintenance LTS_ releases.
Major Node.js versions enter _Current_ release status for six months, which gives library authors time to add support for them. After six months, odd-numbered releases (9, 11, etc.) become unsupported, and even-numbered releases (10, 12, etc.) move to _Active LTS_ status and are ready for general use. _LTS_ release status is "long-term support", which typically guarantees that critical bugs will be fixed for a total of 30 months. Production applications should only use _Active LTS_ or _Maintenance LTS_ releases.
3 changes: 1 addition & 2 deletions locale/en/about/resources.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,8 +9,7 @@ title: Logos and Graphics

Please review the [trademark policy](/en/about/trademark/) for information about permissible use of Node.js® logos and marks.

Guidelines for the visual display of the Node.js mark are described in
the [Visual Guidelines](/static/documents/foundation-visual-guidelines.pdf).
Guidelines for the visual display of the Node.js mark are described in the [Visual Guidelines](/static/documents/foundation-visual-guidelines.pdf).

<table class="logos">
<tr>
Expand Down
26 changes: 4 additions & 22 deletions locale/en/about/trademark.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,28 +5,10 @@ title: Trademark Policy

# Trademark Policy

The Node.js trademarks, service marks, and graphics marks are symbols of the
quality, performance, and ease of use that people have come to associate with
the Node.js software and project. To ensure that the Node.js marks continue to
symbolize these qualities, we must ensure that the marks are only used in ways
that do not mislead people or cause them to confuse Node.js with other software
of lower quality. If we don’t ensure the marks are used in this way, it cannot
only confuse users, it can make it impossible to use the mark to protect
against people who maliciously exploit the mark in the future. The primary goal
of this policy is to make sure that this doesn’t happen to the Node.js mark, so
that the community and users of Node.js are always protected in the future.
The Node.js trademarks, service marks, and graphics marks are symbols of the quality, performance, and ease of use that people have come to associate with the Node.js software and project. To ensure that the Node.js marks continue to symbolize these qualities, we must ensure that the marks are only used in ways that do not mislead people or cause them to confuse Node.js with other software of lower quality. If we don’t ensure the marks are used in this way, it cannot only confuse users, it can make it impossible to use the mark to protect against people who maliciously exploit the mark in the future. The primary goal of this policy is to make sure that this doesn’t happen to the Node.js mark, so that the community and users of Node.js are always protected in the future.

At the same time, we’d like community members to feel comfortable spreading the
word about Node.js and participating in the Node.js community. Keeping that
goal in mind, we’ve tried to make the policy as flexible and easy to understand
as legally possible.
At the same time, we’d like community members to feel comfortable spreading the word about Node.js and participating in the Node.js community. Keeping that goal in mind, we’ve tried to make the policy as flexible and easy to understand as legally possible.

The OpenJS Foundation has a perpetual license to use the
[Node.js marks](https://ip-policy.openjsf.org).
For more details on using the Node.js mark, please read the
[full policy](https://trademark-policy.openjsf.org).
If you have any questions don't hesitate to
[email us](mailto:trademark@openjsf.org).
The OpenJS Foundation has a perpetual license to use the [Node.js marks](https://ip-policy.openjsf.org). For more details on using the Node.js mark, please read the [full policy](https://trademark-policy.openjsf.org). If you have any questions don't hesitate to [email us](mailto:trademark@openjsf.org).

Guidelines for the visual display of the Node.js mark are described in
the [Visual Guidelines](/static/documents/foundation-visual-guidelines.pdf).
Guidelines for the visual display of the Node.js mark are described in the [Visual Guidelines](/static/documents/foundation-visual-guidelines.pdf).
Loading