Как правильно писать комментарий – Как пишется комментарий — секреты лучших комментаторов

Содержание

Как правильно писать комментарии в интернете?

На первый взгляд может показаться, что данный вопрос о правильности написания комментариев достаточно глупый и беспроблемным. Но это только на первый взгляд. В наше время, наверное, каждый может выражать свои мысли…, наверное.

Но когда вопрос затрагивает тему заработка на комментариях, сразу появляются сомнения и проблемы. Так вот, чтобы разобраться в этом, необходимо рассмотреть несколько вопросов: что такое комментарии, как их писать, чтобы ваше мнение лаконично было выражено?

Что представляет собой комментарий?

В первую очередь комментарий – это некий текст, предложение, которое пишется пользователем к какой-нибудь статье или новости, передавая мнение читателя. В свою очередь комментарии участвуют в так называемой раскрутке сайта или ресурса. Это своеобразная реклама. После того, как пользователь оставил комментарий, на него остается открытая ссылка. Таким образом, чем больше комментариев, тем больше ссылок остается на сайт и тем самым может возрасти посещаемость этого сайта.

Как заработать на комментариях к фильмам?

Комментарий не просто набор слов

Можно сказать, что заработок на комментариях – это целая наука. Все гораздо сложнее и серьезнее, а те так – тяп-ляп. Для того, чтобы иметь представление о том, как писать комментарии, необходимо хорошо понимать, о чем он будет и как составить свое высказывание. Для более успешного процесса необходимо прочитать новость или статью, которую вы хотите комментировать. Это будет началом успешного комментария.

Как начать?

Для начала подумаем о том, что написал автор новости или статьи. Согласны ли вы с ним? Проанализируйте прочитанное, разложите по полкам мысли. Готовы ли вы поддержать автора или оспорить? Далее можно выразить свое мнение. Оно должно быть не агрессивным, не оскорбляющим, индивидуальным и ни в коем случае не должно унижать или обидеть автора статьи. Ваш отзыв – это лицо ваших мыслей, интеллекта и воспитания. Если вы хотите вызвать своим комментарием некое уважение и доверие, тогда можно для придания большей солидности поставить на свой профиль на сайте хорошую фотографию себя. Это будет говорить о том, что вы никакой-нибудь фейк, провокатор и «балабол», а личность. Благодаря вам сайт может вызвать больше интереса среди пользователей интернет пространства.

Заработок денег в интернете на написании отзывов

Как правильно писать комментарий, если в голову ничего не приходит?

О да, такое бывает часто. Вот прочитал статью или новость, интересную, эмоций много, а комментировать нечего. Так что же написать? Можно задать логичный по теме вопрос автору статьи. Изложите свою мысль, дополняя статью. Возможно что-то автор упустил. Как вариант, можно найти информацию по теме в интернете, прочитать её и оставить на основе прочитанного комментарий.
Пробуйте выражать свои мысли, не бойтесь спорить с автором, будьте открытым и получайте удовольствие.

idco.ru

комментарий — Викисловарь

В Википедии есть страница «комментарий».

Содержание

  • 1 Русский
    • 1.1 Морфологические и синтаксические свойства
    • 1.2 Произношение
    • 1.3 Семантические свойства
      • 1.3.1 Значение
      • 1.3.2 Синонимы
      • 1.3.3 Антонимы
      • 1.3.4 Гиперонимы
      • 1.3.5 Гипонимы
    • 1.4 Родственные слова
    • 1.5 Этимология
    • 1.6 Фразеологизмы и устойчивые сочетания
    • 1.7 Перевод

Морфологические и синтаксические свойства

падежед. ч.мн. ч.
Им.коммента́рийкоммента́рии
Р.коммента́риякоммента́риев
Д.коммента́риюкоммента́риям
В.коммента́рийкоммента́рии
Тв.коммента́риемкоммента́риями
Пр.коммента́риикоммента́риях

ком-мен-та́-рий

Существительное, неодушевлённое, мужской род, 2-е склонение (тип склонения 7a по классификации А. А. Зализняка).

Корень: -коммент-; суффикс: -арий [Тихонов, 1996].

Произношение

ru.wiktionary.org

Как правильно писать комментарии | Начальная школа прогера



data-ad-client=»ca-pub-9038233983914754″
data-ad-slot=»5706208564″>

 

Глядя на название статьи, можно подумать, что я высосал проблему из пальца. Ну кто нынче не знает, как правильно писать комментарии? Да и что значит, правильно или не правильно? Выразил свое отношение к статье, поделился мнением, если оно есть, и на этом все, конец письма. К тому же, попадаются такие посты, даже на очень жирных сайтах, на которые не знаешь что и написать, а вроде как надо бы.

Хочу поделиться своим взглядом на эту проблему и прояснить, почему я — за то, чтобы все таки писать комментарии на сайтах. Зачастую написание комментария расценивается, как раскрутка чужого сайта, в ущерб своему, если в ответ мы не получаем встречного коммента. Я вам написал, вы мне нет, все, больше не ждите от меня никаких комментариев. На мой взгляд, совсем не правильный подход к делу. Я не спорю, что каждый оставленный комментарий на моем сайте работает в плюс для моего ресурса, но я так же рассматриваю свои, оставленные на другом ресурсе комментарии, как прямую выгоду для развития, именно, моего сайта. 

То, что при написании комментария на чужом сайте остается открытая ссылка на наш сайт, об этом все знают, но почему-то, или забывают, или не придают значения. Чем больше таких ссылок, тем выше у нашего сайта индекс цитирования. Несмотря на то, что Яндекс поменял алгоритм ранжирования, все равно, основная категория сайтов еще анализируется по старому, поэтому, ссылочная масса нам не повредит. Об этом мы с вами уже говорили. 

Другой аспект необходимости правильного написания комментария заключается вот в чем. Не знаю замечали вы или нет, но я замечал, это точно, что иногда, при выдаче статьи в поиске, в качестве описания выдается не тот отрывок текста, который мы указали в Description, а один из комментариев, причем очень креативный, на который, обычно, и реагируешь, при выборе входа на предложенные ресурсы. Как удается поисковику выделить именно его, для описания статьи, остается тайной, покрытой мраком, но факт налицо.



data-ad-client=»ca-pub-9038233983914754″
data-ad-slot=»5706208564″>

Какой из этого можно сделать вывод? А вывод такой: если я буду писать оригинальные, нестандартные комментарии на других сайтах, то на них обязательно обратят внимание не только поисковые системы, но и люди, читающие эти посты.  

Протестируйте сами себя. Когда вы заходите на сайт по интересующему вас запросу, вы что делаете в первую очередь? Кидаетесь читать статью, даже если она написана, знаков, эдак, на две три тысячи? Я например, нет. В первую очередь я читаю комментарии к этой статье или видео, так как по комментариям можно легко и просто составить впечатление о написанном, и только потом, если я вижу, что статья действительно, обсуждаема, с участием админа, читаю весь материал. Кроме того, я всегда обращаю внимание на авторов толковых комментариев, и как правило, перехожу посмотреть, какую же информацию можно почерпнуть на их ресурсах. Понимаете, к чему я клоню? А клоню я к тому, что оставляя интересные, креативные комментарии на других сайтах, мы привлекаем чужую аудиторию на свой ресурс. Это не значит, что мы занимаемся переманиванием, но мы обращаем на себя внимание, а это одно из правил ведения бизнеса, особенно в интернете, другими словами честная конкуренция. Если, перейдя на ваш сайт, посетитель нашел интересный оригинальный контент, считайте, что вы приобрели для себя небольшую целевую аудиторию. 

Сейчас задайте себе вопрос. Если мне на мою статью напишут негативный комментарий, который мне явно не понравится (я не имею ввиду спам, мат и т.п), просто мнение посетителя будет расходиться с моим по поводу описанного в статье, как я себя поведу? Удалю комментарий? Отвечу так, что он больше никогда и носа не сунет на мой сайт? Проигнорирую? Скажу: ну, наконец-то, хоть один негативный комментарий?  Что выберете вы? 

Скажу вам одну тайну. Некоторые админы радуются (а иногда и сами провоцируют), когда на статью приходят комментарии, с альтернативными мнениями, и среди посетителей разгорается спор или диалог по поводу точки зрения, выраженной в статье. Обычно, спор так быстро не заканчивается и к нему примыкают все новые и новые участники, порой, смотришь, первый коммент был написан в 2011 году, а люди до сих пор выражают свое мнение. Это определенные сети, расставленные на посетителей. Люди, существа эмоциональные и не могут пройти спокойно, если рядом обсуждается горячая тема. 

Имея достаточное количество комментариев на сайте, в одном из плагинов, мы можем настроить приоритет страниц так, чтобы робот индексировал сначала страницы с комментариями, а затем уже те, на которых комментариев нет. Таким образом наличие комментариев будет служить основанием для продвижения определенной статьи или страницы.

Хочу подвести итог. Комментарий — это ваша визитная карточка, которую вы раздаете в интернете. Какой она будет, конечно, решать вам. Думаю, что комментарий, типа: все понятно, спасибо, годится только для частной переписки, для пиара такие комментарии не годятся. Помните, что вы работаете на себя любимого, поэтому не ленитесь, своего имени, ради своего бренда можно постараться. Мы сейчас развиваемся все вместе, и примерно в одно и тоже время наши сайты будут взрослеть и обрастать посетителями. Время пролетит быстро, еще чуть-чуть и это будут не новые желторотые сайты, а сайты имеющие вес  ТИЦ и PR. Смотрите немного вперед, ведь комментарии никуда не деваются (если конечно, не будут удалены админом), и ссылки на ваш сайт копятся и когда-то ссылки на ваш сайт уже будут стоять с таких же жирных сайтов, как сейчас некоторые. Ничего не делается быстро, но со временем всегда набирает обороты. Поэтому, старайтесь писать отзывы оригинально, вкладывайте смысл в свои комментарии, ведь это тоже неотъемлемая часть продвижения нашего сайта. 

 

Присоединяйся к обсуждению на форуме



data-ad-client=»ca-pub-9038233983914754″
data-ad-slot=»5706208564″>

www.zhakanov.com

Как комментировать статьи? | Обучение

Обычно бывает так…

Человек читает статью, пропуская написанное через свои фильтры восприятия: личный опыт, верования, убеждения, настроение и т. п. Если изложенное в статье не соответствует этим фильтрам восприятия, просто не умещается, то рука тянется написать: бред, полная чушь, всё не так! А поскольку мозг в таком состоянии думать отказывается, комментарий, по форме, получается приблизительно следующий:

1. Автору в жизни не повезло, поэтому у него…, автору нужно…

Логики в таком комментарии никакой. Далеко не все авторы пишут о себе, а большинство рассматривают явления, ситуации, которые не являются частью жизни автора. Поэтому такая форма комментария — способ пофантазировать об авторе, но не о сути статьи.

2. Сразу понятно, что автор… А дальше идут характеристики, в зависимости от уровня культуры и развития интеллекта комментатора. Опять обсуждается не статья, а приписываемые автору личностные качества. Какой смысл такой формы комментария?

3. А я вот тут подумал… Дальше идут какие-то личные переживания, никак не связанные с темой статьи, содержанием. Так, просто человеку захотелось рассказать что-то своё. Зачем? Кому это интересно? Может быть, в этом случае, лучше написать не комментарий, а свою отдельную статью.

4. Вот тут написано… После чего выдёргивается фраза из контекста, вне которого она уже теряет первоначальный смысл, и по этой фразе делаются выводы, основанные на единичном личном опыте, который совсем не связан с темой, освещенной в статье.

Фото: Depositphotos

5. Да все они…, так всегда…, у него всё время… Набор обобщений, которые никак не относятся к статье. Зачем обобщать, если автор пишет о конкретном случае, варианте из многих возможных, проводит анализ только одного случая. Можно написать, что бывает по-другому, но тогда надо не обобщать, а просто привести другие примеры.

Это не все, но наиболее часто встречающиеся формы комментариев.

Теперь об установках, убеждениях, которые мешают разумному, чёткому, ясному изложению возражений, добавлений к статье…

1. Я знаю, как правильно, моя истина — единственная.

Правда ли, что это так? Нужно ли считать, что автор недоумок и его мнение, по сравнению с вашим, ничего не стоит? То, что знает человек — всегда ограничено его опытом, но интересно, что чем меньше этот опыт, тем больше человек настаивает на его истинности в последней инстанции.

2. Установка писать категорично. Это следствие убеждения: «я всегда прав». Категоричность, выраженная в словах «бред», «чушь», «ерунда» и прочих, характеризует комментатора не с лучшей стороны. Зачем такие комментарии нужны?

3. Неумение соглашаться. Перестать спорить и искать новый смысл в статье для себя — это трудно. Снять убеждённость, что ты мыслишь правильно, а другой ошибается, для многих просто невозможно. Но тогда теряется перспектива получить что-то полезное из прочитанного. Казалось бы, всё просто — найди то, в первую очередь, с чем согласиться можешь, потом изложи своё видение, свой опыт. Но для многих почему-то это непосильная задача. А для вас?

4. Шаблонное мышление: «Я знаю, что это так, а почему — не ваше дело». Ваши шаблоны — только ваши. Мир гораздо шире и богаче любых рамок, и если мысли автора не вписываются в чьи-либо рамки восприятия, это лишь демонстрирует ограниченность воспринимающего материал человека.

5. Я серьёзный и умный, а другие нет. Многим так хочется казаться умными, сказать в комментариях свою единственную правду, что чаще получается совсем наоборот. Для таких полезно вспомнить Мюнхгаузена: «Улыбайтесь господа, умное лицо ещё не признак ума. Все величайшие глупости делаются именно с этим выражением лица».

Как правильно писать комментарии к статьям…

1. Подумайте, зачем вы хотите написать. Например, что добавить, опровергнуть, какие аргументы приведёте, насколько они обоснованны?

2. Согласитесь с тем, с чем можете согласиться. Излагайте своё мнение, указав, как лучше можно было бы изложить то, с чем не согласны.

3. Избегайте категоричности. Она присуща персонажам типа Шарикова из «Собачьего сердца»: «…а взять всё и поделить». Больше используйте выражений: по моему мнению, мне кажется, возможен такой вариант и т. п.

«…а взять всё и поделить»
Кадр из к/ф «Собачье сердце»

4. Разделяйте автора и содержание статьи. Пишите о содержании, автора вы всё равно не знаете, а статья перед вами.

5. Переставайте писать, когда нечего писать. У многих есть удивительная способность — не могут остановиться. Комментарии уже давно не связаны со статьёй, но всё пишут и пишут. Кому? Зачем? Если так хочется, то правильнее написать отдельную статью.

6. Не пишите длинно. Хорошая мысль бывает краткой. Если не смогли уместиться в пять предложений, может быть, это не хорошая мысль?

7. В комментариях пишите свои мысли. Уберите фразы, которые высказывают согласие с ранее высказавшимися комментаторами: «Я согласна с …». Если так, то какой смысл вашего комментария? Ну, сообщили вы миру, что согласны с…, а свои мысли есть? Если нет, зачем писать?

А сейчас — главная рекомендация. Смените уверенность в своей правоте на интерес и любопытство. Задавайте больше вопросов, тогда есть шанс получить хорошие ответы, а комментарии будут полезны и автору статьи, и всем читающим.


shkolazhizni.ru

Что такое комментарии к проблеме и как их написать: клише для комментирования

Одним из самых непростых этапов работы во время написания текста можно назвать комментарий проблемы. Это не просто ваше мнение по поводу прочитанного, это грамотные рассуждения автора о проблеме, затронутой в письменной работе, его замечания и размышления.

По комментарию можно сделать вывод о том, насколько хорошо была понята тема, проследил ли за авторской мыслью пишущий и так далее.

О проблеме не нужно много дискутировать, хороший комментарий к ней выражается обычно в трех – четырех развернутых фразах, в том числе клише.

Виды комментария

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

Комментарии к проблеме делятся на два вида:

  • текстуальный. Под этим подразумевается рассмотрение и изучение проблемы только в рамках самого текста и его других компонентов, таких как художественные средства, персонажи, композиция и так далее;
  • концептуальный. Под этим же видом комментария подразумевается рассмотрение проблемы в глобальном смысле, то есть в рамках традиций, восприятия читателя, сегодняшнего времени и другое. Гораздо масштабнее, чем в тексте.

Нужно понимать, что текстуальный комментарий не является кратким пересказом текста, надо не переписывать содержание, а акцентироваться на проблеме и следить за главной авторской мыслью, раскрывающую тему произведения.

Чтобы было проще писать данный вид комментария, нужно ответить на такие вопросы:

  1. В какой из трех смысловых частей текста автор формулирует проблему?
  2. На чем конкретно автор делает акцент при обращении к проблеме?
  3. Какие факты и события затрагиваются?
  4. Как автор аргументирует свою позицию?
  5. Как он выражает свое отношение к рассматриваемой проблеме?

При написании концептуального комментария следует найти ответы на более глобальные вопросы:

  1. Какого характера затронутая проблема: социального, экономического, политического и так далее.
  2. Как рассматриваемая проблема связана с автором произведения и почему привлекла его внимание?
  3. Является ли проблема актуальной и насколько она значима для социума?
  4. Часто ли вы сталкиваетесь с такой проблемой?

Ну и, конечно, что лично вы чувствуете, рассуждая об этой проблеме, передаются ли вам переживания самого автора.

Выявляем проблему

Для начала нужно сформулировать проблему

Мало просто прокомментировать прочитанный текст, нужно написать размышления о проблеме, которую еще нужно правильно выявить и понять:

  • для начала нужно проанализировать отношения между героями, их поступки;
  • выясните, проявляются в этих отношениях отрицательные или положительные качества героев;
  • подберите названия этим качествам, такие как любовь, честь, долг, эгоизм и так далее;

Попробуйте сформулировать проблему, опираясь на выявленные качества.

Как написать комментарий

В комментарии очень важно то, как пишущий видит проблему, как он ее понимает, как он пришел к таким определенным выводам.

Пишите, что думаете. Чтобы написать хороший комментарий, не нужно использовать много умных слов и цитат.

Достаточно просто открыть свой разум и поразмышлять над парочкой вопросов, связанными с текстом, который вы собрались комментировать:

  • определите кому адресован текст, почему проблема интересна этому кругу читателей;
  • определите, отрицательное или положительное впечатление на вас производит текст, на какие детали автор акцентируется больше всего, как он пытается решить данную проблему;
  • прочувствуйте настроение автора, отметьте в чем оно проявляется, в каких фразах и деталях текста;

Подумайте о том, что пытается подчеркнуть автор, рассматривая эту проблему, к каким умозаключением он подводит своего читателя.

Ошибки комментирования

При написании комментария нужно опираться на текст

Можно выделить следующие ошибки:

  • при написании комментария вы не опираетесь на текст;
  • вместо комментирования самой проблемы вы пишите пересказ либо заменяете это цитированием;
  • ваш комментарий не соответствует рассматриваемой проблеме.

Важно помнить, что, когда вы пишете комментарий к проблеме сочинения, нужно обязательно опираться на контекст, связывать свои формулировки с авторской позицией.

Также в своем комментарии не забывайте отражать ход мыслей и позицию автора и приводить примеры из текста (минимум 2). Используйте небольшие фразы и предложения из прочитанного текста.

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

Такие неловкие манипуляции сразу бросаются в глаза, так как нарушают логичность. Найти нужную цитату – половина дела. Важно правильно ее оформить, потому что неправильно оформленная цитата является орфографической ошибкой.

Выпишите в черновик самые важные моменты: слова, фразы с наименованием проблемы, абзацы с выбранными примерами, тезисы и аргументы. Не ленитесь проверять правильность написания различных названий и цитат, указывайте номера предложений, на которые будете ссылаться.

Не путайтесь в содержании, бывает, что комментарий пишут не к той проблеме, которую изначально формулировали. Только после того, как вы окончательно все проверили, принимайтесь за написание в чистовик.

В этом видео вы узнаете, как писать комментарии к тексту:

Заметили ошибку? Выделите ее и нажмите Ctrl+Enter, чтобы сообщить нам.

vyuchit.work

как правильно писать комментарий к проблеме текста ЕГЭ по русскому языку


23.11.2018

 Разбираем подробно как получить максимальные 5 баллов в критерии К2 — как правильно сформулировать комментарий к исходной проблеме в тексте ЕГЭ по русскому языку. Данные актуальны на 2019 год.

Важно:

 Автор: Ирина Анатольевна Суязова.

ЧТО ДОЛЖНО БЫТЬ, чтобы получить 5 баллов

  1. Сформулированная экзаменуемым проблема прокомментирована с опорой на исходный текст.
  2. Экзаменуемый привёл не менее 2 примеров-иллюстраций из прочитанного текста, важных для понимания проблемы.
  3. Дано пояснение к 2 приведённым примерам.
  4. Выявлена смысловая связь между ними.

Комментарий состоит из 5 элементов:

  1. Пример-иллюстрация (исходный текст).
  2. Пояснение (мысли самого ученика по поводу примера-иллюстрации).
  3. Второй пример-иллюстрация (исходный текст).
  4. Пояснение (мысли самого ученика по поводу примера-иллюстрации).
  5. Смысловая связь между примерами-иллюстрациями.

В качестве комментария можно использовать:

  • примеры, которые приводит автор в своём тексте;
  • размышления автора, связанные с проблемой;
  • цитаты;
  • описания;
  • истории;
  • точки зрения, которые приводит автор;
  • средства выразительности,
  • слова, выражения, важные для понимания проблемы.

Дополнительно:

Либо смотри вебинар из 2 уроков

Урок №1

Урок №2

Смотреть в PDF:

Или прямо сейчас: cкачать в pdf файле.

Сохранить ссылку:

Добавить комментарий

Рекламные и несодержательные сообщения удаляются.

www.ctege.info

Как правильно комментировать код / Habr

Как-то раз сидел в аудитории с ноутом около розетки, а в это время на соседней парте принимался зачет по программированию. Я не сильно вникал в суть вопросов на которые общались студент и преподаватель, назовем его Иван Ивановичем. Разговор был довольно спокойный и тихий, но у меня получилось выхватить часть. Преподаватель говорил о комментариях (видимо сдавалась программа, в которой не было ни строчки комментариев). Меня этот момент заинтересовал и я начал прислушиваться. Было замечено, что мне тоже интересно, преподаватель начал импровизированную лекцию. Ниже представлен тот небольшой кусок знаний который я тогда вынес с этой 5ти минутной лекции.

Хочется сразу предупредить, что для многих описанное здесь — очевидные вещи, однако, новичкам в коллективном программировании (когда над кодом работают 2 и более программиста) и студентам будет полезно. Кроме того, все изложенные ниже советы имеют альтернативу и могут быть использованы лишь частично.

Почему я приписал сюда студентов? Они же, казалось бы, одни работают над программой на зачет! Препод, когда принимает программу, справедливо считается вторым разработчиком, который в идеале без помощи студента должен понять, что там написано и как оно работает.

Как писать код сразу с комментариями

По сути говоря, на той лекции принцип TDD (Test-driven development, разработка через тестирование) был перенесен на уровень ниже. Не помню как это звучало в оригинале, но по сути «Опиши комментариями структуру кода». На примере (сильно утрированном, почему — ниже) кода программы, складывающей два числа, этот принцип будет выглядеть так:

int main()
{
     // Принять от пользователя два числа
     // Завести переменную для результата сложения
     // Вернуть результат сложения

     return 0;
}

И лишь когда готов каркас из комментариев, следует писать код который будет реализовывать то, что описано комментариями.

...
int main()
{
     double a,b;
     // Принять от пользователя два числа
     cin>>a;
     cin>>b;
     //Завести переменную для результата сложения
     double sum = a+b;
     // Вернуть результат сложения
     cout<<sum;

     return 0;
}

Как упоминалось выше, данный принцип представляет собой модифицированный принцип, хорошо зарекомендовавшего себя TDD. Тут следует понимать, что отступление от комментариев, в отличии от отступления от логики тестов, не приведет к тяжелым последствиям, ну разве что придется комментарии переписывать

Теперь представим «чисто гипотетическую» ситуацию, когда уже имеется код в 200 000 строк, написанный гениальным программистом криворуким индусом и не содержит ни строчки комментария. Однако вам необходимо, мало того что убить этого программиста понять этот код, но и сопровождать его в дальнейшем. Вы даже разобрались в этом коде, и будучи приличным человеком, решили дополнить код комментариями для, так сказать, будущих поколений. Но возникает вопрос: как?

Как комментировать уже существующий код

Ответ на этот вопрос довольно прост: комментируем сущности от родителя к потомку: класс -> метод -> код внутри метода (если необходимо).

Вполне логично будет задуматься: а что не нужно комментировать. Комментировать не надо в двух случаях (один из них поясняет почему пример кода выше был сильно утрированный):

  • Совсем уж очевидные вещи. Комментарии вида // инициализируем счетчик бесят больше чем их отсутствие
  • Непонятный код дополнять комментарием типа // ничего не понял

Относительно второго пункта стоит немного пояснить и привести пример: вставка 100 строк ассемблера код на C! Вы на нее смотрите и пишите комментарий // Многа букаф! Ниасилил
После этого человек пришедший после вашего увольнения на ваше место видит этот комментарий и… все! Он даже не будет пытаться в нем разобраться и эта ваша запись будет клеймом на этом куске кода до тех пор пока его не уберут (либо код, либо комментарий).

Напоследок

В заключение могу сказать, что искусство написания комментариев является неотъемлемой частью искусства программирования, поэтому комментарии писать надо, и, как бы пафосно это не звучало, но написанию качественных комментариев надо учиться.

habr.com

Author: alexxlab

Отправить ответ

avatar
  Подписаться  
Уведомление о