English -> Polish; translations for the Node.js Framework (#4)

source

Node.js

GitHub nodejs/node

Node.js® is a JavaScript runtime built on Chrome's V8 JavaScript engine.

The Node.js Foundation’s mission is to enable widespread adoption and help accelerate development of Node.js and other related modules. They do this through an open governance model that encourages participation and technical contribution, and by providing a framework for long term stewardship by an ecosystem invested in Node.js’ success.

source

It is widely appreciated as one of the best modern frameworks for building the backend of a web application. While it is still far from the most popular choice for such a framework, it is growing every day. I think node.js is one of the most revolutionary and important open source projects out there, which is why I want to help it grow by translating their massive cirriculum into the Polish language.

Contribution Specifications

Translation Overview

In this post, I've chosen to translate the errors.md file. It's very ambitious at trying to explain in great detail how node.js errors work, how they interract with standard JavaScript error objects, but also how to handle them in conventional and unconventional ways.

I've chosen to translate this file (and node.js in general) because I have a background in programming that let's me understand those texts in great detail. It is proving to be a serious challenge, due to code jargon not having any set in stone translations, but keeping a self-made dictionary of words helps me out greatly with making sure I remain consistent.

Here's a preview of what strings I had to deal with:

Summary of the role of Errors in node.js

The use of the 'error' event mechanism is most common for stream-based and event emitter-based APIs, which themselves represent a series of asynchronous operations over time (as opposed to a single operation that may pass or fail). For all [EventEmitter][] objects, if an 'error' event handler is not provided, the error will be thrown, causing the Node.js process to report an uncaught exception and crash unless either: The domain module is used appropriately or a handler has been registered for the ['uncaughtException'][] event.

Quick explaination of the node.js Error Class

Class: Error
A generic JavaScript Error object that does not denote any specific circumstance of why the error occurred. Error objects capture a "stack trace" detailing the point in the code at which the Error was instantiated, and may provide a text description of the error. For crypto only, Error objects will include the OpenSSL error stack in a separate property called opensslErrorStack if it is available when the error is thrown. All errors generated by Node.js, including all System and JavaScript errors, will either be instances of, or inherit from, the Error class.

Languages

This text was translated from English into Polish.

Polish - mother tongue
English - C2

Word Count

For this contribution, I've translated 1035 words into Polish.

Crowdin Details

nodejs activity stream
my Crowdin profile