Skip to content

Commit 071d440

Browse files
Apply suggestions from code review
11 sugerencias ok Co-authored-by: Ezequiel Castellanos <51804994+ezzep66@users.noreply.github.com>
1 parent 6eea635 commit 071d440

1 file changed

Lines changed: 11 additions & 11 deletions

File tree

1-js/03-code-quality/04-ninja-code/article.md

Lines changed: 11 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,7 @@ Muchos intentan seguir los caminos de los ninjas. Pocos tienen éxito.
2020

2121
## La brevedad es el alma del ingenio
2222

23-
Has el código lo más corto posible. Demuestra cuan inteligente eres.
23+
Haz el código lo más corto posible. Demuestra cuán inteligente eres.
2424

2525
Deja que las características sutiles del lenguaje te guíen.
2626

@@ -52,7 +52,7 @@ Una variable exótica como el contador de un bucle es especialmente genial si el
5252

5353
## Usa abreviaciones
5454

55-
Si las reglas del equipo prohíben el uso de nombres de una sola letra o nombres vagos -- acórtalos, has abreviaciones.
55+
Si las reglas del equipo prohíben el uso de nombres de una sola letra o nombres vagos -- acórtalos, haz abreviaciones.
5656

5757
Como esto:
5858

@@ -63,7 +63,7 @@ Como esto:
6363

6464
Solo aquel con buena intuición será capaz de entender dichos nombres. Intenta acortar todo. Solo una persona digna debería ser capaz de sostener el desarrollo de tu código.
6565

66-
## Vuela alto. Se abstracto
66+
## Vuela alto. abstracto
6767

6868
```quote author="Laozi (Tao Te Ching)"
6969
El gran cuadrado no tiene esquina<br>
@@ -109,7 +109,7 @@ A quick read of such code becomes impossible. And when there's a typo... Ummm...
109109
Es difícil encontrar un gato negro en una habitación oscura, sobre todo cuando no está.
110110
```
111111

112-
Usando nombres *similar* para las mismas cosas hace tu vida mas interesante y le muestra al público tu creatividad.
112+
Usando nombres *similares* para las mismas cosas hace tu vida mas interesante y le muestra al público tu creatividad.
113113

114114
Por ejemplo, considera prefijos de funciones. Si una función muestra un mensaje en la pantalla -- comiénzalo con `mostrar...`, como `mostarMensaje`. Y entonces si otra función muestra en la pantalla otra cosa, como un nombre de usuario, comiénzalo con `presentar...` (como `presentarNombre`).
115115

@@ -121,9 +121,9 @@ Has un pacto con tus compañeros ninjas del equipo: si John comienza funciones d
121121

122122
Para dos funciones con importantes diferencias -- ¡usa el mismo prefijo!
123123

124-
Por ejemplo, la función `imprimirPagina(pagina)` usara una impresora. Y la función `imprimirTexto(texto)` mostrará el texto en la pantalla.. Deja que un lector no familiar a tu código piense sobre una función llamada de forma similar `imprimirMensaje`: "¿Dónde coloca el mensaje? ¿A una impresora o en la pantalla?. Como guinda al pastel, ¡`imprimirMensaje(mensaje)` debería mostrar el mensaje en una nueva ventana!
124+
Por ejemplo, la función `imprimirPágina(página)` usara una impresora. Y la función `imprimirTexto(texto)` mostrará el texto en la pantalla.. Deja que un lector no familiar a tu código piense bien sobre una función llamada de forma similar `imprimirMensaje`: "¿Dónde coloca el mensaje? ¿A una impresora o en la pantalla?. Para que realmente se destaque, ¡`imprimirMensaje(mensaje)` debería mostrar el mensaje en una nueva ventana!
125125

126-
## Reúsa nombres
126+
## Reutilizar nombres
127127

128128
```quote author="Laozi (Tao Te Ching)"
129129
Una vez que el todo se divide, las partes <br>
@@ -132,15 +132,15 @@ Ya hay suficientes nombres. <br>
132132
Uno debe saber cuándo parar.
133133
```
134134

135-
Añade una nueva variable solo cuando sea necesario.
135+
Añade una nueva variable sólo cuando sea necesario.
136136

137-
En lugar, reúsa nombres que ya existen. Simplemente escribe nuevo valores en ellos.
137+
En lugar, reutiliza nombres que ya existen. Simplemente escribe nuevo valores en ellos.
138138

139-
En una función intenta solo usar las variables pasadas como parámetro.
139+
En una función intenta sólo usar las variables pasadas como parámetros.
140140

141141
Eso hará que sea realmente difícil identificar qué es exactamente la variable *ahora*. Y además de donde viene. El propósito es desarrollar la intuición y memoria de la persona que lee el código. Una persona con intuición débil tendrá que analizar el código línea por línea y seguir los cambios en cada rama de código.
142142

143-
**Una variante avanzada del enfoque es reemplazar los valores de forma encubierta con algo igual en la mitad de un bucle o una función.**
143+
**Una variante avanzada del enfoque es reemplazar los valores de forma encubierta con algo parecido en la mitad de un bucle o una función.**
144144

145145
Por ejemplo:
146146

@@ -210,7 +210,7 @@ Una expresión de sorpresa aturdida aparecerá en la cara de tus colegas cuando
210210

211211
**Otra forma de sorprender es retornar un resultado no estándar**
212212

213-
¡Muestra tu pensamiento original! Deja que la llamada de `comprobarPermiso` retorne no `true/false`, pero un objeto complejo con los resultados de tu comprobación.
213+
¡Muestra tu pensamiento original! Deja que la llamada de `comprobarPermiso` retorne no `true/false` sino un objeto complejo con los resultados de tu comprobación.
214214

215215
## Funciones poderosas!
216216

0 commit comments

Comments
 (0)