diff --git a/guide/russian/java/comments-in-java/index.md b/guide/russian/java/comments-in-java/index.md index dd77b9eb85..c855defd83 100644 --- a/guide/russian/java/comments-in-java/index.md +++ b/guide/russian/java/comments-in-java/index.md @@ -4,9 +4,9 @@ localeTitle: Комментарии в Java --- ## Комментарии в Java -Комментарии в java похожи на записи в реальной жизни, которые используются для отображения некоторой информации, которую другие программисты или разработчики могут читать и понимать. +Комментарии в java похожи на заметки в реальной жизни, которые используются для отображения некоторой информации, которую другие программисты или разработчики могут читать и понимать. -Хорошая практика - добавлять комментарии к вашему коду, особенно при работе с командой или в компании. Это помогает будущим разработчикам или товарищам по команде узнать, что происходит более легко, когда они смотрят на ваш код. Комментарии делают ваш код более аккуратным и организованным. +Хорошая практика - добавлять комментарии к вашему коду, особенно при работе с командой или в компании. Это помогает будущим разработчикам или товарищам по команде легче понять, что происходит в вашем коде. Комментарии делают ваш код более аккуратным и организованным. Комментарии Java не выполняются компилятором и интерпретатором. @@ -14,22 +14,22 @@ localeTitle: Комментарии в Java #### 1\. Одиночный комментарий -Чтобы создать однострочный комментарий просто добавить два `//` слэши перед текстом. +Чтобы создать однострочный комментарий просто добавить два `//` слэша перед текстом. ```java -// This is how single line comment looks like +// Так выглядит однострочный комментарий ``` -#### 2\. Комментарий Multi Line +#### 2\. Многострочный комментарий -Чтобы создать многострочный комментарий, заверните строки между `/*` линиями здесь `*/` +Чтобы создать многострочный комментарий, заверните строки между символами : `/*` ваш комментарий `*/` ```java public class MyFirstJava { public static void main(String[] args) { - /* This Java Code - Prints out "Hello world" - and you are looking at a multi line comment + /* Этот java код + выводит сообщение "Hello World" + и вы смотрите на многострочный комментарий */ System.out.println("Hello World"); } @@ -38,12 +38,12 @@ public class MyFirstJava { #### 3\. Комментарий к документации -Комментарий к документации используется инструментом Javadoc для создания документации для кода. Документация Комментарий используется разработчиками для документирования кода, например, что делает класс или что делает метод. Это используется инструментом javadoc, который будет компилировать предварительно отформатированный набор html-файлов, содержащих всю информацию, доступную в комментарии. +Комментарий к документации используется инструментом Javadoc для создания документации для кода. Комментарий документации используется разработчиками для документирования кода, например, что какие функции выполняет класс или что делает метод. Это используется инструментом javadoc, который будет компилировать предварительно отформатированный набор html-файлов, содержащих всю информацию, доступную в комментарии. ```java /** - * The Following Java program displays a random between 0 - 50 - * Most Developer dont document simple program like this + * Эта программа выводит случайное число от 0 до 50 в консоль + * Большинство разработчиков не документируют такие простые программы * * @author Quincy Larson * @version 1.0 @@ -61,4 +61,4 @@ public class MyFirstJava { * [Ресурсы Java](http://guide.freecodecamp.org/java/resources/) -* [Скомпилированный пример Javadoc](https://docs.oracle.com/javase/8/docs/api/) \ No newline at end of file +* [Скомпилированный пример Javadoc](https://docs.oracle.com/javase/8/docs/api/)