Skip to content
This repository was archived by the owner on Jan 20, 2022. It is now read-only.

docs #142

Closed
wants to merge 19 commits into from
Closed

docs #142

Show file tree
Hide file tree
Changes from all commits
Commits
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
39 changes: 39 additions & 0 deletions locale/es/docs/es6.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,39 @@
---
title: ES6 y más allá
layout: docs.hbs
---
# ES6 y más allá

Node.js esta construyendo en nuevas versiones con [motor V8](https://developers.google.com/v8/). Manteniendo día a día, con las últimas versiones, podemos asegurar que tendrá nuevas caracteristas de [la especificación en JavaScript ECMA-262 ](http://www.ecma-international.org/publications/standards/Ecma-262.htm) que serán llevadas por los desarrolladores Node.js a su tiempo y forma, así como las continuas mejoras de rendimiento y estabilidad.

Las características de ECMAScript 2015 (ES6), se pueden dividir en tres grandes grupos:

* Características **shipping**, en el cual se motor V8 considera estable, se **activan automáticamente** en NodeJs en la versión por defecto, y **NO** requiere ningún tipo de argumento inicial.
* Características **Staged**, estas son consideradas como **inestables**, por lo tanto requiere el argumento `--harmony` al iniciar el runtime.
* Características **In progress**, estas se necesitan ser activadas individualmente, con la respectivo argumento de `--harmony`, no es recomendable porque está **en prueba**. Nota: Estos argumentos y características pueden cambiar o eliminarse sin previo aviso por el motor V8.

## ¿Cuales son las características de Node.js en la versión por defecto?

En la Web [node.green](http://node.green) provee un excelente resumen de las caracteristicas de ECMAScript, soportadas en varias versiones de Node.js.

## ¿Cuales son las características en **in progress** ?

Las nuevas características, que estamos incorporando para el motor V8. Generalmente se hablan, y se espera que sean lanzadas en las versiones futuras de Node.js, pero no sabemos cuando.

Usted puede leer la lista de *in progress*, estas caracteristicas estan disponibles en cada versión final de Node.js puede verlas con el argumento `--v8-options`. Recuerde que estas características están incompletas en el motor V8, uselas bajo su propio riesgo.

```bash
node --v8-options | grep "in progress"
```

## En mi infraestructura se esta usando el argumento `--harmony`. ¿Debería quitarlo?

La comportamiento actual del argumento `--harmony` en Node.js, estas características están activas en **staged**. Pero antes de todo, es un sinónimo a `--es_staging`. Como se mencionó anteriormente, estas son características, aun son inestables. Si usted desea ir a lo seguro, especialmente en entornos de producción, deberia considerar la eliminación de ese argumento del runtime hasta que las características esten forma predeterminada en V8 y, en consecuencia, en Node.js. Si, mantiene el argumento activado, usted debe estar preparado para más actualizaciones Node.js para romper o modificarlo su código dado que la semántica puede cambiar.

## ¿Cómo encuentro la versión del motor V8 con una versión particular de Node.js?

Node.js porvee un simple objeto de **todas** las dependencias y sus respectivas versiones, que se entregan el binario, están especificados en el objeto global `process`. En este caso el motor V8, se puede ejecutar en su terminal así.

```bash
node -p process.versions.v8
```
19 changes: 19 additions & 0 deletions locale/es/docs/faq.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,19 @@
---
title: FAQ
layout: docs.hbs
---
# Preguntas frecuentes

## ¿Cómo puedo contribuir?

¡Todos podemos ayudar! Todos los integrantes de Node.Js aceptan el [codigo de conducta](https://github.com/nodejs/node/blob/master/CONTRIBUTING.md#code-of-conduct), y las contribuciones y liberaciones (releases) estan bajo un modelo de [gobierno abierto](https://github.com/nodejs/node/blob/master/GOVERNANCE.md#readme).

Para empezar, usted puede revisar las discuciones abiertas en GitHub de [NodeJs](https://github.com/nodejs/node/issues) y [comunidad en español](https://github.com/nodejs/nodejs-es/issues), y **nosotros amamos leer todo tipo realimentación!** Involucrarse en discusiones es una excelente idea para empezar puedes ayudar a salir a delante el proyecto. Si usted puede ayudar a crear codigo, perfectamente puede ayudarnos, por favor lea [hacer un pull request](https://github.com/nodejs/node/blob/master/CONTRIBUTING.md#code-contributions).

## ¿En donde estan las discusiones?

Nos encontramos en los canales #node.js y en #node.js-es, en Freenode por IRC. Tenemos logs del canal, puede leerlos [aqui](http://logs.libuv.org/node.js/latest).

## ¿Que es un gobierno de código abierto?

Gobierno de código libre, defiende la aplicación de una filosofía de código abierto, su contenido y sus acciones, con el fin de permitir que cualquier persona, institución o/y empresa interesada a contribuir el producto final, como un documento wiki. La legislación, es democrática para la ciudadanía en general y los interesados, empleando su sabiduría colectiva para beneficiar el proceso de toma de decisiones y mejorar la democracia. [[source]](https://en.wikipedia.org/wiki/Open-source_governance)
78 changes: 78 additions & 0 deletions locale/es/docs/meta/topics/dependencies.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,78 @@
---
title: Dependencies
layout: docs.hbs
---

# Dependencias

Aquí están todas las dependencias de Node.Js con las cuales trabaja

- [Librerías](#Librerías)
- [V8](#V8)
- [libuv](#libuv)
- [http-parser](#http-parser)
- [c-ares](#c-ares)
- [OpenSSL](#OpenSSL)
- [zlib](#zlib)
- [Herramientas](#Herramientas)
- [npm](#npm)
- [gyp](#gyp)
- [gtest](#gtest)

## Librerías

### V8

El V8 es una librería que provee a Node.Js con un motor de JavaScript, en el cual los controles esta vía V8 C++ API. V8 está mantenido por Google, lo usa en Chrome.

- [Documentacion](https://v8docs.nodesource.com/)

### libuv

Es una dependencia muy importante, una librería en C que se usa en abstracto de non-blocking I/O de operaciones de una interfaz consistente a través de todo ello apoyado del sistema operativo. Esta librería proporciona mecanismos para manejar el sistema de archivos, DNS, red, subprocesos, pipes (Tuberías), manejo de señales (signal.h), polling y streaming. Esto incluye un grupo de subprocesos para la descarga de trabajo, en los cuales para algunas cosas que no se pueden hacer de forma asíncrona a nivel de sistema operativo.

- [Documentacion](http://docs.libuv.org/)

### http-parser

http-parser, es una librería ligera hecha en C. Está diseñada para no hacer ninguna llamada del sistema o asignaciones, por lo que tiene una huella muy pequeña de memoria por solicitud.

- [Documentacion](https://github.com/joyent/http-parser/)

### c-ares

Para algunas peticiones de DNS, Node.Js usa esta librería en C. Se usa a través del módulo "DNS" en JavaScript en `resolve()`. El resto de la biblioteca está usado por la función `lookup()`, que se usa como un multihilo en `getaddrinfo(3)` y que llama a libuv. La razón por la cual se usa, es porque soporta `/etc/hosts`, `/etc/resolv.conf` y `/etc/svc.conf`, pero no cosas como mDNS

- [Documentacion](http://c-ares.haxx.se/docs.html)

### OpenSSL

Esta librería se usa extensamente en los modulos de `tls` y `crypto`. Esta provee implementaciones ya probados, con muchas funciones criptográficas que la web moderna se basa en la seguridad.

- [Documentacion](https://www.openssl.org/docs/)

### zlib

Para una rápida compresión y descompresión, Esta es librería estándar de la industria, también conocido por su uso en gzip y libpng. Node.Js usa esta para sincronización, compresión y transmisión asíncrona y la descompresión.

- [Documentacion](http://www.zlib.net/manual.html)

## Herramientas

### npm

Esta herramienta, se usa como una modularidad y con eso viene la necesidad de un gestor de paquetes. Por eso se creó [NPM](http://npmjs.com), esta herramienta tiene la mayor sección de paquetes creados por la comunidad de JavaScript, lo que hace la construcción de aplicaciones en Node.Js rapida y facil.

- [Documentacion](https://docs.npmjs.com/)

### gyp

Un sistema de construcción por gyp, un generador de proyectos basado en python copiado de V8. Este puede generar archivos de proyectos para el uso de múltiples plataformas o sistemas operativos. Esta herramienta es indispensable para la compilación de las anteriores librerías, que son dependencias necesarias de NodeJs.

- [Documentacion](https://chromium.googlesource.com/external/gyp/+/master/docs/UserDocumentation.md)

### gtest

Es una herramienta que testea el código, en nativo, en el cual toma Chromium. Permite una prueba en C/C++ sin necesidad de ejecutar todo el paquete.

- [Documentacion](https://code.google.com/p/googletest/wiki/V1_7_Documentation)
8 changes: 8 additions & 0 deletions locale/es/get-involved/code-and-learn.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
---
title: Codigo y Aprende
layout: contribute.hbs
---

# Codigo y Aprende

Codigo y Aprende es una iniciativa mundial de talleres para introducir nuevos desarrolladores para trabajar en Node.js. Con el apoyo, sesiones prácticas son asesorados por los colaboradores existentes y ayudando a resolver problemas reales.
34 changes: 34 additions & 0 deletions locale/es/get-involved/contribute.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,34 @@
---
title: Contribuye
layout: contribute.hbs
---

# Contribuye

¡Gracias! Por su interés para contribuir en Node.Js, nosotros tenemos múltiples formas y lugares, en los cuales usted puede contribuir y estamos aquí, para ayudar a facilitar eso.

## Reporte un problema/issue

Si usted a encontrado algo que cree que es un problema con Node.Js por favor no dude presentar el problema en los Issues en el proyecto de Github. Recuerde que debe mencionar el procedimiento que ejecuto, debe ser reproducible, no debe incluir ningún dependencias externas, y en inglés. Es decir, se podra ejecutar el mismo error solo con Node.Js.

Al informar del problema necesitamos la mayor cantidad de información, que usted darnos sobre tu entorno. Nunca se sabe que información será importante para resolver el problema. Por favor incluya estos datos.

* Versión de Node.Js
* Plataforma, en este caso donde está corriendo (OS X, SunOS, Linux, Windows, etc..)
* Arquitectura que se está corriendo (32bit o 64Bit y x86 o ARM)

El proyecto Node.js es administrado actualmente a través de una serie de repositorios de GitHub separados, cada uno con su propia base de datos de temas separados. Si es posible, por favor, dirija cualquier problema que está reportando al repositorio más adecuado, pero no se preocupe. Si esto sucede, escribir el problema en el lugar equivocado, la comunidad de colaboradores será más que feliz de ayudar a conseguir que apunta en el lugar correcto.

* Reportar un problema/tema especifico de Node.Js por favor [nodejs/node](https://github.com/nodejs/node)
* Reportar un problema/tema con la web [nodejs/nodejs.org](https://github.com/nodejs/nodejs.org/issues)
* Reportar un problema/tema con la comunidad en español [nodejs/nodejs-es](https://github.com/nodejs/nodejs-es/issues)

## Contribuye al código

Si deseas resolver errores o añadir nuevas características a Node.Js, por favor consulta [política de desarrollo de Node.js](/es/get-involved/development/).

Antes de hacer cualquier contribución puede ser aceptado y en cualquier parte del proyecto, pero antes debe ser revisado por los colaboradores existentes en concordancia de las [política de desarrollo Node.Js](/es/get-involved/development/)

## Conviértase en un colaborador

Recuerde que al convertirse en un colaborador, sus contribuciones son de mayor impacto para el proyecto. Ellos pueden ayudar a otros contribuyentes y colaboradores mediante la revisión de sus aportes, colaboración de resolución de problemas (Issues) y tomar parte en la dirección que llevará el proyecto. Node.js siempre está buscando personas que estén interesadas en convertirse en colaboradores. Si le interesa, tendra que seguir la [Política de Desarrollo Node.js](/es/get-involved/development/)