Skip to content

Commit 239f1b6

Browse files
authored
Update article.md
1 parent c14449c commit 239f1b6

1 file changed

Lines changed: 22 additions & 22 deletions

File tree

1-js/02-first-steps/02-structure/article.md

Lines changed: 22 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -2,21 +2,21 @@
22

33
Lo primero que estudiaremos son los bloques de construcción del código.
44

5-
## Declaraciones
5+
## Sentencias
66

7-
Las declaraciones son construcciones de sintaxis y comandos que realizan acciones.
7+
Las sentencias son construcciones sintácticas y comandos que realizan acciones.
88

9-
Ya hemos visto una sentencia, `alert('¡Hola, mundo!')`, que muestra el mensaje "¡Hola mundo!".
9+
Ya hemos visto una sentencia, `alert('¡Hola mundo!')`, que muestra el mensaje "¡Hola mundo!".
1010

11-
Podemos tener tantas declaraciones en nuestro código como queramos. Las declaraciones se pueden separar con un punto y coma.
11+
Podemos tener tantas sentencias en nuestro código como queramos, las cuales se pueden separar con un punto y coma.
1212

13-
Por ejemplo, aquí dividimos "Hello World" en dos alertas:
13+
Por ejemplo, aquí separamos "Hello World" en dos alerts:
1414

1515
```js run no-beautify
1616
alert('Hola'); alert('Mundo');
1717
```
1818

19-
Generalmente, las declaraciones se escriben en líneas separadas para hacer que el código sea más legible:
19+
Generalmente, las sentencias se escriben en líneas separadas para hacer que el código sea más legible:
2020

2121
```js run no-beautify
2222
alert('Hola');
@@ -46,20 +46,20 @@ alert(3 +
4646
+ 2);
4747
```
4848

49-
El código da como resultado `6` porque JavaScript no inserta punto y coma aquí. Es intuitivamente obvio que si la línea termina con un signo más `"+"`, entonces es una "expresión incompleta", por lo que no se requiere el punto y coma. Y en este caso eso funciona según lo previsto.
49+
El código da como resultado `6` porque JavaScript no inserta punto y coma aquí. Es intuitivamente obvio que si la línea termina con un signo más `"+"`, es una "expresión incompleta", por lo que no se requiere el punto y coma. Y en este caso eso funciona según lo previsto.
5050

5151
**Pero hay situaciones en las que JavaScript "falla" al asumir un punto y coma donde realmente se necesita.**
5252

5353
Los errores que ocurren en tales casos son bastante difíciles de encontrar y corregir.
5454

55-
````smart header="Un ejemplo de un error."
56-
Si tiene curiosidad por ver un ejemplo concreto de tal error, consulte este código:
55+
````smart header="Un ejemplo de error"
56+
Si tienes curiosidad por ver un ejemplo concreto de tal error, mira este código:
5757
5858
```js run
5959
[1, 2].forEach(alert)
6060
```
6161
62-
No es necesario pensar en el significado de los corchetes `[]` y `forEach` todavía. Los estudiaremos más adelante. Por ahora, solo recuerda el resultado del código: muestra `1` luego `2`.
62+
No es necesario pensar en el significado de los corchetes `[]` y `forEach` todavía, los estudiaremos más adelante. Por ahora, solo recuerda el resultado del código: muestra `1` luego `2`.
6363
6464
Ahora, agreguemos un 'alert' antes del código y *no* terminemos con un punto y coma:
6565
@@ -69,9 +69,9 @@ alert("Habrá un error")
6969
[1, 2].forEach(alert)
7070
```
7171
72-
¡Ahora si ejecutamos el código, solo se muestra el primer `alert` y luego tenemos un error!
72+
Ahora, si ejecutamos el código, ¡solo se muestra el primer `alert` y luego tenemos un error!
7373
74-
Pero todo está bien de nuevo si agregamos un punto y coma después de `alert`:
74+
Pero todo está bien nuevamente si agregamos un punto y coma después de `alert`:
7575
```js run
7676
alert("Todo bien ahora");
7777
@@ -83,16 +83,16 @@ Ahora tenemos el mensaje "Todo bien ahora" seguido de `1` y `2`.
8383
8484
El error en la variante sin punto y coma se produce porque JavaScript no asume un punto y coma antes de los corchetes `[...]`.
8585
86-
Entonces, como el punto y coma no se inserta automáticamente, el código del primer ejemplo se trata como una sola declaración. Así es como lo ve el motor:
86+
Entonces, como el punto y coma no se inserta automáticamente, el código del primer ejemplo se trata como una sola sentencia. Así es como lo ve el motor:
8787
8888
```js run no-beautify
8989
alert("Habrá un error")[1, 2].forEach(alert)
9090
```
9191
92-
Pero deberían ser dos declaraciones separadas, no una. Tal unión en este caso es simplemente incorrecto, de ahí el error. Esto puede suceder en otras situaciones.
92+
Pero deberían ser dos sentencias separadas, no una. Tal unión en este caso es simplemente incorrecta, de ahí el error. Esto puede suceder en otras situaciones también.
9393
````
9494

95-
Recomendamos colocar puntos y coma entre las declaraciones, incluso si están separadas por nuevas líneas. Esta regla es ampliamente adoptada por la comunidad. Notemos una vez más que es posible omitir los puntos y comas la mayoría del tiempo. Pero es más seguro, especialmente para un principiante, usarlos.
95+
Recomendamos colocar puntos y coma entre las sentencias, incluso si están separadas por saltos de línea. Esta regla está ampliamente adoptada por la comunidad. Notemos una vez más que es posible omitir los puntos y coma la mayoría del tiempo. Pero es más seguro, especialmente para un principiante, usarlos.
9696

9797
## Comentarios
9898

@@ -101,16 +101,16 @@ A medida que pasa el tiempo, los programas se vuelven cada vez más complejos. S
101101
Los comentarios se pueden poner en cualquier lugar de un script. No afectan su ejecución porque el motor simplemente los ignora.
102102

103103

104-
**Los comentarios de una línea comienzan con dos caracteres de barra diagonal //.**
104+
**Los comentarios de una línea comienzan con dos caracteres de barra diagonal `//`.**
105105

106-
El resto de la línea es un comentario. Puede ocupar una línea completa propia o seguir una declaración.
106+
El resto de la línea es un comentario. Puede ocupar una línea completa propia o seguir una sentencia.
107107

108108
Como aqui:
109109
```js run
110110
// Este comentario ocupa una línea propia.
111111
alert('Hello');
112112

113-
alert('World'); // Este comentario sigue a la declaración.
113+
alert('World'); // Este comentario sigue a la sentencia.
114114
```
115115

116116
**Los comentarios de varias líneas comienzan con una barra inclinada y un asterisco <code>/&#42;</code> y terminan con un asterisco y una barra inclinada <code>&#42;/</code>.**
@@ -136,11 +136,11 @@ alert('Hola');
136136
alert('Mundo');
137137
```
138138

139-
```smart header="¡Use accesos rapidos del teclado!"
140-
En la mayoría de los editores, se puede comentar una línea de código presionando `key:Ctrl+/` para un comentario de una sola línea y algo como `key:Ctrl+Shift+/` - para comentarios de varias líneas (seleccione una parte del código y pulse la tecla de acceso rápido). Para Mac, intente `key: Cmd` en lugar de `key: Ctrl`.
139+
```smart header="¡Usa accesos rápidos del teclado!"
140+
En la mayoría de los editores, se puede comentar una línea de código presionando `key:Ctrl+/` para un comentario de una sola línea y algo como `key:Ctrl+Shift+/` - para comentarios de varias líneas (selecciona una parte del código y pulsa la tecla de acceso rápido). Para Mac, intenta `key: Cmd` en lugar de `key: Ctrl`.
141141
```
142142

143-
````warn header="Los comentarios anidados no son compatibles!"
143+
````warn header="¡Los comentarios anidados no son compatibles!"
144144
No puede haber `/*...*/` dentro de otro `/*...*/`.
145145
146146
Dicho código terminará con un error:
@@ -155,7 +155,7 @@ alert( 'Mundo' );
155155

156156
Por favor, no dudes en comentar tu código.
157157

158-
Los comentarios aumentan el tamaño general del código, pero eso no es un problema en absoluto. Hay muchas herramientas que minimizan el código antes de publicar en un servidor de producción. Eliminan los comentarios, por lo que no aparecen en los scripts de trabajo. Por lo tanto, los comentarios no tienen ningún efecto negativo en la producción.
158+
Los comentarios aumentan el tamaño general del código, pero eso no es un problema en absoluto. Hay muchas herramientas que minimizan el código antes de publicarlo en un servidor de producción. Eliminan los comentarios, por lo que no aparecen en los scripts de trabajo. Por lo tanto, los comentarios no tienen ningún efecto negativo en la producción.
159159

160160
Más adelante, en el tutorial, habrá un capítulo <info:coding-style> que también explica cómo escribir mejores comentarios.
161161

0 commit comments

Comments
 (0)