Change several wordings of the text. (#30674)

This commit is contained in:
Igor Burianenko
2019-04-25 07:36:05 +03:00
committed by Randell Dawson
parent 49b1e94f33
commit c7f24919b2

View File

@ -7,19 +7,25 @@ localeTitle: Комментарий
---
## Description
<section id="description"> Комментарии - это строки кода, которые JavaScript намеренно игнорирует. Комментарии - это отличный способ оставить заметки для себя и для других людей, которым позже нужно будет понять, что делает этот код. Существует два способа написания комментариев в JavaScript: Использование <code>//</code> говорит JavaScript игнорировать оставшуюся часть текста в текущей строке: <blockquote> // Это встроенный комментарий. </blockquote> Вы можете сделать многострочный комментарий, начинающийся с <code>/*</code> и заканчивающийся на <code>*/</code> : <blockquote> /* Это <br> многострочный комментарий * / </blockquote> <strong>Лучшая практика</strong> <br> Когда вы пишете код, вы должны регулярно добавлять комментарии, чтобы уточнить функцию частей вашего кода. Хороший комментарий может помочь сообщить о том для чего используется ваш код - как другим, так <em>и</em> вам в будущем. </section>
<section id="description"> Комментарии представляют собой строки кода, которые JavaScript игнорирует. Использование комментариев является отличным способом оставить заметки себе или другим, кому придется разбираться в работе кода.
Комментарии в JavaScript бывают двух видов :
Два идущих подряд слэша <code>//</code> являются указанием игнорировать весь идущий за ними текст на этой строке:
<blockquote> // Это комментарий в строке. </blockquote>
Также можно сделать многострочный комментарий: он должен начинаться с <code>/*</code> и заканчиваться на <code>*/</code> :
<blockquote> /* Это <br> многострочный комментарий * / </blockquote>
<strong>Лучшая практика</strong> <br> В процессе написания кода имеет смысл регулярно добавлять комментарии, в которых будет описываться функциональность различных частей кода. Хороший комментарий может помочь разобраться в сути вашего кода - как другим людям, так <em>и</em> вам в будущем. </section>
## Instructions
<section id="instructions"> Попробуйте создать один из комментариев каждого типа. </section>
<section id="instructions"> Попробуйте создать один из комментариев каждого вида. </section>
## Tests
<section id='tests'>
```yml
tests:
- text: 'Создайте комментарий стиля <code>//</code> , содержащий не менее пяти букв.'
- text: 'Создайте комментарий вида <code>//</code>, содержащий не менее пяти букв.'
testString: 'assert(code.match(/(\/\/)...../g), "Create a <code>//</code> style comment that contains at least five letters.");'
- text: 'Создайте комментарий <code>/* */</code> style, содержащий не менее пяти букв.'
- text: 'Создайте комментарий вида <code>/* */</code>, содержащий не менее пяти букв.'
testString: 'assert(code.match(/(\/\*)([^\/]{5,})(?=\*\/)/gm), "Create a <code>/* */</code> style comment that contains at least five letters.");'
```