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 72% of the project!

Translation Overview

In my previous contribution I worked on the Domain Module Postmortem folder, briefly based on the Domain folder that I translated on this occasion.

This module is currently deprecated. Some users agree that it doesn't matter if they are deprecated, domains are awesome if you use them right. Domains provide a way to handle multiple different IO operations as a single group and are useful for trapping errors thrown asynchronously. Using the global uncaughtException and unhandledRejection handlers don't solve the problem either. Only Domains can catch arbitrary errors like this.

Domains are useful for framework: they're a good way to separate 'user logic' from internal 'framework logic' for the purposes of failure handling and recovery.

Note that 'failure handling' is different from 'error handling'. A failure is a side effect to an Error. The user of a framework should be allowed to handle errors however they like, but sometimes you want the framework to decide how to handle the subsequent failure which resulted from that error.

For example, the framework itself might invoke a user-defined function which might branch off in unpredictable ways
and invoke various functions synchronously and/or asynchronously. In such a situation, if the user's code throws an Error, you may not want to just kill the whole server: you just want to shut down the single socket which was related to the specific action which caused the problem.

Basically, as a framework developer, domains offer you the ability to control the failure handling aspects related to code written by a third party.

If you're still not familiar about how domains are useful, you can see this Github gist.

I will add as an example of translation a section of this module as a warning/advice:

---

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 1621 words.
• I've translated a total of 97802 words so far*

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

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

• Domain Module Postmortem

Part 71

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