---

name: Комментарии
theory: |

  Кроме кода, в файлах с исходным кодом могут находиться комментарии. Это текст, который не является частью программы, и нужен программистам для пометок. С их помощью добавляют пояснения, как работает код, какие ошибки нужно поправить или не забыть что-то позже добавить.

  Комментарии в PHP бывают двух видов:

  ## Однострочные комментарии

  _Однострочные комментарии_ начинаются с `//`. После этих символов может следовать любой текст, вся строчка не будет анализироваться и исполняться.

  Комментарий может занимать всю строчку. Если одной строчки мало, то создаются несколько комментариев:

  ```php
  <?php

  // For Winterfell!
  // For Lanisters!
  ```

  Комментарий может находиться на строчке после какого-нибудь кода:

  ```php
  <?php
  print_r('I am the King'); // For Lannisters!
  ```

  ## Многострочные комментарии

  _Многострочные комментарии_ начинаются с `/*` и заканчиваются на `*/`. Между ними каждая строчка должна начинаться с символа `*`.

  ```php
  <?php
  /*
   * The night is dark and
   * full of terrors.
   */
  print_r('I am the King');
  ```

instructions: |
  Создайте однострочный комментарий с текстом: `You know nothing, Jon Snow!`.

tips: []

definitions:
  - name: Комментарий
    description: |
      текст в коде программы, который не влияет на функциональность, и добавляется программистами для себя и своих коллег.

      `// однострочный комментарий`

      ```
      /*
      * многострочный комментарий
      * многострочный комментарий
      */
      ```
