You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: 1-js/03-code-quality/04-ninja-code/article.md
+11-11Lines changed: 11 additions & 11 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -20,7 +20,7 @@ Muchos intentan seguir los caminos de los ninjas. Pocos tienen éxito.
20
20
21
21
## La brevedad es el alma del ingenio
22
22
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.
24
24
25
25
Deja que las características sutiles del lenguaje te guíen.
26
26
@@ -52,7 +52,7 @@ Una variable exótica como el contador de un bucle es especialmente genial si el
52
52
53
53
## Usa abreviaciones
54
54
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.
56
56
57
57
Como esto:
58
58
@@ -63,7 +63,7 @@ Como esto:
63
63
64
64
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.
65
65
66
-
## Vuela alto. Se abstracto
66
+
## Vuela alto. Sé abstracto
67
67
68
68
```quote author="Laozi (Tao Te Ching)"
69
69
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...
109
109
Es difícil encontrar un gato negro en una habitación oscura, sobre todo cuando no está.
110
110
```
111
111
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.
113
113
114
114
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`).
115
115
@@ -121,9 +121,9 @@ Has un pacto con tus compañeros ninjas del equipo: si John comienza funciones d
121
121
122
122
Para dos funciones con importantes diferencias -- ¡usa el mismo prefijo!
123
123
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!
125
125
126
-
## Reúsa nombres
126
+
## Reutilizar nombres
127
127
128
128
```quote author="Laozi (Tao Te Ching)"
129
129
Una vez que el todo se divide, las partes <br>
@@ -132,15 +132,15 @@ Ya hay suficientes nombres. <br>
132
132
Uno debe saber cuándo parar.
133
133
```
134
134
135
-
Añade una nueva variable solo cuando sea necesario.
135
+
Añade una nueva variable sólo cuando sea necesario.
136
136
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.
138
138
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.
140
140
141
141
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.
142
142
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.**
144
144
145
145
Por ejemplo:
146
146
@@ -210,7 +210,7 @@ Una expresión de sorpresa aturdida aparecerá en la cara de tus colegas cuando
210
210
211
211
**Otra forma de sorprender es retornar un resultado no estándar**
212
212
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.
0 commit comments