Skip to content

Commit

Permalink
Merge pull request #219 from kant/patch-1
Browse files Browse the repository at this point in the history
Semantic issues & minor fixes
  • Loading branch information
leobalter committed May 14, 2021
2 parents 846287a + d2a7ac4 commit 8834ad5
Showing 1 changed file with 21 additions and 21 deletions.
42 changes: 21 additions & 21 deletions translations/es_ES/readme.md
Expand Up @@ -108,9 +108,9 @@ Los proyectos deberían tratar de incluir siempre algún mecanismo para que el c

### Testing

Los proyectos _deben_ incluir alguna forma de testing (test unitario, test funcional, etc). Las demos NO CUENTAN como "tests". A continuación, una lista de frameworks para testing, ninguno de los cuales recomiendo más que otro.
Los proyectos _deben_ incluir alguna forma de prueba (test unitario, test funcional, etc). Las demos NO CUENTAN como "tests". A continuación, una lista de frameworks para testing, ninguno de los cuales recomiendo más que otro.

* [QUnit](http://github.com/jquery/qunit)
* [QUnit](https://github.com/jquery/qunit)
* [Jasmine](https://github.com/pivotal/jasmine)
* [Vows](https://github.com/cloudhead/vows)
* [Mocha](https://github.com/visionmedia/mocha)
Expand All @@ -123,7 +123,7 @@ Los proyectos _deben_ incluir alguna forma de testing (test unitario, test funci

* [Espacios en blanco](#whitespace)
* [Beautiful Syntax](#spacing)
* [Checkeo de tipos (Cortesía de la guía de estilo de jQuery)](#type)
* [Comprobación de tipos (Cortesía de la guía de estilo de jQuery)](#type)
* [Evaluación condicional](#cond)
* [Estilo práctico](#practical)
* [Naming](#naming)
Expand All @@ -139,7 +139,7 @@ Los proyectos _deben_ incluir alguna forma de testing (test unitario, test funci

## Prólogo

Las siguientes secciones delinean una guía de estilos _razonable_ para desarrollo moderno de JavaScript, y no intentan ser prescriptivas. Lo más importante es la **ley de consistencia de estilo de código**. Cualquiera sea el estilo que escojas para tu proyecto debería ser considerado ley. Piensa en este documento como una declaración del compromiso para con la consistencia de estilo, legibilidad y mantenibilidad.
Las siguientes secciones delinean una guía de estilos _razonable_ para un desarrollo moderno de JavaScript, y no intentan ser prescriptivas. Lo más importante es la **ley de consistencia de estilo de código**. Cualquiera sea el estilo que escojas para tu proyecto debería ser considerado ley. Piensa en este documento como una declaración del compromiso para con la consistencia de estilo, legibilidad y mantenibilidad.



Expand Down Expand Up @@ -344,7 +344,7 @@ Las siguientes secciones delinean una guía de estilos _razonable_ para desarrol

// Expresión de función con identificador
// Esta forma es preferida porque tiene el valor agregado de
// poder ser llamada a sí misma y ser identificable en el seguimiento de la pila (MUY útil para debugging) :
// poder ser llamada a sí misma y ser identificable en el seguimiento de la pila (MUY útil para debugging):
var factorial = function factorial( number ) {
if ( number < 2 ) {
return 1;
Expand Down Expand Up @@ -377,7 +377,7 @@ Las siguientes secciones delinean una guía de estilos _razonable_ para desarrol
// 2.C.1.1
// Funciones con callbacks
foo(function() {
// Como se ve no hay espacio entre el primer paréntesis
// Como se ve, no hay espacio entre el primer paréntesis
// y la palabra "function"
});

Expand All @@ -404,7 +404,7 @@ Las siguientes secciones delinean una guía de estilos _razonable_ para desarrol
D. La consistencia siempre gana

En las secciones 2.A-2.C, las reglas para los espacios son puestas con un objetivo más simple y con un propósito más general: consistencia.
Es importante destacar que algunas preferencias de formato, deberían ser consideradas opcionales, pero solo un estilo debería existir a través de todo el código de fuente de tu proyecto.
Es importante destacar que algunas preferencias de formato, deberían ser consideradas opcionales, pero solo un estilo debería existir a través de todo el código fuente de tu proyecto.

```javascript

Expand Down Expand Up @@ -432,13 +432,13 @@ Las siguientes secciones delinean una guía de estilos _razonable_ para desarrol

E. Comillas

Si prefieres comillas simples o dobles no debería importar, no hay diferencias en como JavaScript las parsea. Lo que **ABSOLUTAMENTE DEBE** ser cumplido es la consistencia. **Nunca mezclar comillas en el mismo proyecto. Elegir un estilo y cumplirlo.**
Si prefieres comillas simples o dobles no debería importar, no hay diferencias ya que JavaScript las parsea. Lo que **ABSOLUTAMENTE DEBE** ser cumplido es la consistencia. **Nunca mezclar comillas en el mismo proyecto. Elegir un estilo y cumplirlo a rajatabla.**

F. Fin de línea y líneas vacías

Espacios en blanco pueden arruinar diffs y hacer los cambios imposibles de leer. Considera agregar algún mecanismo para remover automáticamente los espacios que se encuentran al final de la línea o en líneas vacías.

3. <a name="type">Checkeo de tipos (Cortesía de la guía de estilo de jQuery)</a>
3. <a name="type">Verificación de tipos (Cortesía de la guía de estilo de jQuery)</a>

A. Tipos

Expand Down Expand Up @@ -516,12 +516,12 @@ Las siguientes secciones delinean una guía de estilos _razonable_ para desarrol
...

// En algún lugar, más tarde en tu código, necesitas modificar `foo`
// con un nuevo valor derivado de el elemento input del HTML
// con un nuevo valor derivado del elemento input del HTML

foo = document.getElementById("foo-input").value;

// Si vas a testear `typeof foo` ahora, el resultado sería `string`
// Esto significa que si hubieras tenido lógica que comparara `foo` así:
// Esto significa que si hubieras tenido lógica que comparar `foo` así:

if ( foo === 1 ) {

Expand Down Expand Up @@ -638,7 +638,7 @@ Las siguientes secciones delinean una guía de estilos _razonable_ para desarrol
// false

// Nótese que el ejemplo anterior debería ser considerado "innecesariamente inteligente"
// Prefiérase el approach obvio de comparar el valor retornado de
// Prefiérase el método obvio de comparar el valor retornado de
// indexOf, como en:

if ( array.indexOf( "a" ) >= 0 ) {
Expand All @@ -665,7 +665,7 @@ Las siguientes secciones delinean una guía de estilos _razonable_ para desarrol
// Todos resultan en 2


// Tener en cuenta que números negativos serán tratados de otra manera...
// Tener en cuenta que los números negativos serán tratados de otra manera...

var neg = -2.5;

Expand Down Expand Up @@ -754,7 +754,7 @@ Las siguientes secciones delinean una guía de estilos _razonable_ para desarrol


// 4.1.7
// Cuando solamente se esta evaluando una referencia que puede ser null o undefined, pero NO false, "" or 0,
// Cuando solamente se está evaluando una referencia que puede ser null o undefined, pero NO false, "" or 0,
// en lugar de:
if ( foo === null || foo === undefined ) ...

Expand All @@ -766,7 +766,7 @@ Las siguientes secciones delinean una guía de estilos _razonable_ para desarrol
null == undefined

```
SIEMPRE evaluar por el mejor, más preciso resultado - lo de arriba es sólo una guía, no un dogma.
SIEMPRE evaluar por el mejor, por el resultado más preciso - lo de arriba es sólo una guía, no un dogma.

```javascript

Expand Down Expand Up @@ -886,7 +886,7 @@ Las siguientes secciones delinean una guía de estilos _razonable_ para desarrol



A. Si no eres un compilador/compresor humano de código, no te esfuerces por de serlo.
Si no eres un compilador/compresor humano de código, no te esfuerces por serlo.

A continuación ejemplos "tristes" de nombramiento de variables

Expand Down Expand Up @@ -988,13 +988,13 @@ Las siguientes secciones delinean una guía de estilos _razonable_ para desarrol
stream.read( opts.path, function( data ) {

// Actualizar el valor de la instancia
// con el valor mas reciente del
// con el valor más reciente del
// data stream
this.value = data;

}.bind(this) );

// Regular la frecueancia de eventos emitidos de
// Regular la frecuencia de eventos emitidos de
// esta instancia de Device
setInterval(function() {

Expand Down Expand Up @@ -1129,7 +1129,7 @@ Las siguientes secciones delinean una guía de estilos _razonable_ para desarrol

7. <a name="misc">Varios</a>

Esta sección servirá para describir ideas y conceptos que no deberían se considerados dogmas, pero existen para alentar a cuestionarse prácticas, en un intento para encontrar mejores maneras de llevar a cabo tareas comunes de programación en JavaScript.
Esta sección servirá para describir ideas y conceptos que no deberían ser considerados dogmas, pero existen para alentar a cuestionarse prácticas, en un intento para encontrar mejores maneras de llevar a cabo tareas comunes de programación en JavaScript.

A. El uso de `switch` debería ser evitado, ya que los métodos modernos de tracing marcarán como negativas las funciones que contengan sentencias `switch`.

Expand Down Expand Up @@ -1158,7 +1158,7 @@ Las siguientes secciones delinean una guía de estilos _razonable_ para desarrol

// 7.A.1.2
// Una manera alternativa que soporta componibilidad y reusabilidad es
// usar un objeto para guardad "cases" y una función para delegar:
// usar un objeto para guardar "cases" y una función para delegar:

var cases, delegator;

Expand Down Expand Up @@ -1306,4 +1306,4 @@ Cualquier proyecto que cite este documento como una guía para estilo no va a ac
----------


<a rel="license" href="http://creativecommons.org/licenses/by/3.0/deed.en_US"><img alt="Creative Commons License" style="border-width:0" src="http://i.creativecommons.org/l/by/3.0/80x15.png" /></a><br /><span xmlns:dct="http://purl.org/dc/terms/" property="dct:title">Principles of Writing Consistent, Idiomatic JavaScript</span> by <a xmlns:cc="http://creativecommons.org/ns#" href="https://github.com/rwldrn/idiomatic.js" property="cc:attributionName" rel="cc:attributionURL">Rick Waldron and Contributors</a> is licensed under a <a rel="license" href="http://creativecommons.org/licenses/by/3.0/deed.en_US">Creative Commons Attribution 3.0 Unported License</a>.<br />Based on a work at <a xmlns:dct="http://purl.org/dc/terms/" href="https://github.com/rwldrn/idiomatic.js" rel="dct:source">github.com/rwldrn/idiomatic.js</a>.
<a rel="license" href="https://creativecommons.org/licenses/by/3.0/deed.en_US"><img alt="Creative Commons License" style="border-width:0" src="https://i.creativecommons.org/l/by/3.0/80x15.png" /></a><br /><span xmlns:dct="http://purl.org/dc/terms/" property="dct:title">Principles of Writing Consistent, Idiomatic JavaScript</span> by <a xmlns:cc="https://creativecommons.org/ns#" href="https://github.com/rwldrn/idiomatic.js" property="cc:attributionName" rel="cc:attributionURL">Rick Waldron and Contributors</a> is licensed under a <a rel="license" href="https://creativecommons.org/licenses/by/3.0/deed.en_US">Creative Commons Attribution 3.0 Unported License</a>.<br />Based on a work at <a xmlns:dct="http://purl.org/dc/terms/" href="https://github.com/rwldrn/idiomatic.js" rel="dct:source">github.com/rwldrn/idiomatic.js</a>.

0 comments on commit 8834ad5

Please sign in to comment.