Repository

https://github.com/nodejs/i18n

Project Details

Node.js is an open-source, cross-platform JavaScript run-time environment that executes JavaScript code outside of a browser.

Node.js came into existence when the original developers of JavaScript extended it from something you could only run in the browser to something you could run on your machine as a standalone application.

In simple words, it's an open source execution environment for developing web applications, which is event-based, it uses the V8 engine to provide an execution environment that compiles and executes JavaScript at a higher speed. It is possible to run Node.js without any restriction on Windows, Linux and Mac OS X.

It should be noted that it is NOT a server language, this means that it executes code, so it could be understood as an interpreter.

Contribution Specifications

Node.js is currently being translated into 33 languages. I'm contributing to translate it into the Spanish language.

So far, we have managed to translate 71% of the project!

Translation Overview

For this contribution I translated the folder Domain Module Postmortem of the v6.x version of Node.js. It is based on the Domain module of the same version, which I plan to translate later.

Via GIPHY

Let's briefly see what is a domain and the postmortem metadata:

Domains provide a way to handle multiple different IO operations as a single group. If any of the event emitters or callbacks registered to a domain emit an 'error' event, or throw an error, then the domain object will be notified

On the other hand, postmortem metadata are constants present in the final build which can be used by debuggers and other tools to navigate through internal structures of software when analyzing its memory.

I bring a gif from GIPHY of the debuggers and tools navigating through the internal structures -ba dum tssss-

The Domain Module Postmortem module is basically divided into two parts: usability issues and performance issues.

In the first section there are several examples that qualify as problems of use, one of them is the following:

It's possible for a developer to create a new domain and then simply run domain.enter(). Which then acts as a catch-all for any exception in the future that couldn't be observed by the thrower. Allowing a module author to intercept the exceptions of unrelated code in a different module. Preventing the originator of the code from knowing about its own exceptions.

In the Performance Issues section, the most important factor is overload.

A significant deterrent from using domains is the overhead. Using node's built-in http benchmark, http_simple.js, without domains it can handle over 22,000 requests/second. Whereas if it's run with NODE_USE_DOMAINS=1 that number drops down to under 17,000 requests/second. In this case there is only a single global domain. If the benchmark is edited so that the callback of the http request creates a new domain instance, the performance is further reduced to 15,000 requests/second. This means even adding 1 microsecond overhead per call for any type of setup or tear down will result in a 17%.

Via GIPHY

I will add as an example of translation one of the problems of usability of domains:

---

Languages

This contribution was translated from English to Spanish.

Word Count

The number of words reflected in the title doesn't include words that didn't require a translation.

• In this contribution, I've translated 1636 words.
• I've translated a total of 95875 words so far*

*Considering non-translatable content (proper names, functions, codes, etc.)

To see my previous contributions in this project, check this!

• Writing-tests.md

Part 70

• N-api.md.

From Part 62 to Part 69

• Timers-in-node.md

Part 61

• Maintaining-V8.md (v6.x)

Parts 59 and 60

• Net.md

Parts 57 and 58

• Onboarding.md

Part 56

• Event-loop-timers-and-nexttick.md

Parts 54 and 55

• VM.md

Part 53

• Building-node-with-Ninja.md

Part 52

• ChangeLog_V7.md

From Part 41 to Part 51

• ChangeLog_V8.md

From Part 14 to Part 40

• Using-Internal-Errors.md and Building-Node-with-Ninja.md

Part 13

• Maintaining-V8.md (v10.x)

Parts 11 and 12.

• Pull-requests-md

From Part 7 to Part 10

• TLS.md

From Part 1 to Part 6

Proof of Authorship

This counter includes non-translatable words, so it is necessary to work on more content to extract an average of 1000 translatable words.

You can check My Crowdin Profile for verify my contribution in this project.