From 135cc90a7694a6ae7c56bb806004607d05719985 Mon Sep 17 00:00:00 2001 From: Damian Suarez Date: Tue, 5 Jun 2012 12:58:24 -0300 Subject: [PATCH] translate 'About this documentation' --- doc/api/documentation.markdown | 88 +++++++++++++++++----------------- 1 file changed, 45 insertions(+), 43 deletions(-) diff --git a/doc/api/documentation.markdown b/doc/api/documentation.markdown index 70a76c2..7e1f71b 100644 --- a/doc/api/documentation.markdown +++ b/doc/api/documentation.markdown @@ -1,68 +1,70 @@ -# About this Documentation +# Acerca de esta documentación -The goal of this documentation is to comprehensively explain the Node.js -API, both from a reference as well as a conceptual point of view. Each -section describes a built-in module or high-level concept. +El objetivo de este documento es explicar integralmente la API Node.js, tanto +como una referencia, como así también un punto de vista conceptual. Cada +sección describe un módulo integrado (built-in module) o un concepto de alto nivel +(high-level concept). -Where appropriate, property types, method arguments, and the arguments -provided to event handlers are detailed in a list underneath the topic -heading. +En su caso, los tipos de propiedades, los argumentos de métodos, y los argumentos +proporcionados a los controladores de eventos se detallan en una lista debajo +de la cabecera del topic. -Every `.html` document has a corresponding `.json` document presenting -the same information in a structured manner. This feature is -experimental, and added for the benefit of IDEs and other utilities that -wish to do programmatic things with the documentation. +Cada documento `.html` tiene un documento correspondiente `.json` presentando +la misma información de una manera estructurada. Esta característica es +experimental, y se agrega para el beneficio de las IDEs y otras utilidades que +desean hacer cosas programáticas con la documentación. -Every `.html` and `.json` file is generated based on the corresponding -`.markdown` file in the `doc/api/` folder in node's source tree. The -documentation is generated using the `tools/doc/generate.js` program. -The HTML template is located at `doc/template.html`. +Cada archivo `.html` y `.json` es generado en base al correspondiente archivo +`.markdown` en la carpeta `doc/api` en el árbol del código fuente de node. La +documentación es generada utilizando el programa `tools/doc/generate.js`. La +plantilla html esta ubicada en `doc/template.html`. -## Stability Index +## Índice de estabilidad -Throughout the documentation, you will see indications of a section's -stability. The Node.js API is still somewhat changing, and as it -matures, certain parts are more reliable than others. Some are so -proven, and so relied upon, that they are unlikely to ever change at -all. Others are brand new and experimental, or known to be hazardous -and in the process of being redesigned. +A lo largo de la documentación verá las indicaciones de estabilidad de cada +sección. La API Node.js es algo cambiante, y a medida que madura, ciertas +partes son más confiables que otras. Algunas están tan probados, y son tan +confiables que es poco probable que cambie en absoluto. Otros son completamente +nuevos y experimentales, o se considera peligroso y en proceso de ser rediseñado. -The notices look like this: +Los avisos se parecen a esto: Stability: 1 Experimental -The stability indices are as follows: +Los índices de estabilidad son los siguientes: -* **0 - Deprecated** This feature is known to be problematic, and changes are -planned. Do not rely on it. Use of the feature may cause warnings. Backwards -compatibility should not be expected. +* **0 - Deprecated** Esta característica es conocida como problemática, y se han +previsto cambios. No confíe en esto. El uso de esta característica puede causar +advertencias. -* **1 - Experimental** This feature was introduced recently, and may change -or be removed in future versions. Please try it out and provide feedback. -If it addresses a use-case that is important to you, tell the node core team. +* **1 - Experimental** Esta característica se ha incluído recientemente y puede +cambiar o ser removida en futuras versiones. Por favor, pruébela y de feedback. +Si esta dirige a un caso de uso importante para usted, hágalo saber al equipo +principal de node. -* **2 - Unstable** The API is in the process of settling, but has not yet had -sufficient real-world testing to be considered stable. Backwards-compatibility -will be maintained if reasonable. +* **2 - Unstable** La API está en el proceso de resolución, pero todavia no ha +sido suficientemente testeada en el mundo real para ser considerada estable. +Si es razonable se mantendrá compatiblidad con versiones anteriores -* **3 - Stable** The API has proven satisfactory, but cleanup in the underlying -code may cause minor changes. Backwards-compatibility is guaranteed. +* **3 - Stable** La API ha resultado satisfactoria, pero limpiar en el código +subyacente puede causar pequeños cambios. La compatibilidad con versiones +anteriores está garantizada. -* **4 - API Frozen** This API has been tested extensively in production and is -unlikely to ever have to change. +* **4 - API Frozen** La API ha sido testeada ampliamente en producción y es +poco provable que alguna vez tenga cambias. -* **5 - Locked** Unless serious bugs are found, this code will not ever -change. Please do not suggest changes in this area; they will be refused. +* **5 - Locked** Al menos que bugs serios sean encontrados este código nunca +cambiará. Por favor no sugiera cambios en esta parte, serán rechazados. -## JSON Output +## salida JSON Stability: 1 - Experimental -Every HTML file in the markdown has a corresponding JSON file with the -same data. +Cada archivo HTML en el markdown tiene un correspondiente archivo JSON con los +mismos datos. -This feature is new as of node v0.6.12. It is experimental. +Esta característica se agregó a partir de node v0.6.12. Es experimental.