Вопрос Как нужно комментировать код?

Тема в разделе "C, C++", создана пользователем MOR, 12 авг 2018 в 22:23.

  1. MOR

    MOR Постоянный участник

    Регистрация:
    28 июл 2017
    Сообщения:
    63
    Симпатии:
    115
    Прошу программистов, у которых больше опыта в коллективной разработке объяснить как нужно комментировать код, а точнее, насколько подробно? И правильно ли я это делаю? Спасибо.

    Screenshot_1.png
    Screenshot_2.png
     
  2. BlackKnigga

    BlackKnigga читы самп в лс
    Всефорумный модератор

    Регистрация:
    10 янв 2016
    Сообщения:
    922
    Симпатии:
    449
    вот это еще забыл
    ...
    var = 12 + 10 // складывает два числа
    ...
    Не нужно комментировать каждую строку кода, пиши по делу.
    Итак очевидно что делает функция .clear или как работают циклы и условия
     
    MOR нравится это.
  3. Aniki

    Проверенный

    Регистрация:
    3 сен 2017
    Сообщения:
    326
    Симпатии:
    194
  4. SR_team

    SR_team BH Team
    BH Team

    Регистрация:
    26 окт 2013
    Сообщения:
    3.052
    Симпатии:
    2.862
    Первый скрин хорошо, второй - уебищно. Еще совет, когда описываешь немспейсы, функции, и переменные - используй doxygen. Комменты используй в реализации для описания блоков кода.
     
    MOR нравится это.