Написать комментарии: Пишем комментарии правильно » Журнал практической электроники Датагор

Содержание

что это такое и как их писать

Комментарии в интернете нужны для быстрого обмена мнениями между читателями. Это-то что-то вроде отзывов. Прочитали статью или посмотрели видеоролик – высказались.

 

Комментарии – это отдельная часть страницы, через которую можно поддержать или оспорить точку зрения автора или просто высказаться по поводу написанного/увиденного.

Такая функция есть на большинстве информационных сайтов и блогов. Также она имеется в социальных сетях – Одноклассниках, Вконтакте, Facebook, Youtube и других.

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

Можно, конечно, поискать адрес электронной почты автора и написать ему письмо. Не исключено даже, что он его прочитает и как-то отреагирует. Но это сложный способ, да и не каждый публикует свои контактные данные. Гораздо проще написать комментарий, в котором поделиться тем, что знаешь и умеешь. Скорее всего, автор прочитает это сообщение и ответит на него. И другие читатели статьи тоже увидят эту информацию и смогут высказаться.

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

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

Где найти комментарии

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

Выглядят они примерно так:

В Одноклассниках они находятся под каждой новостью, заметкой или фотографией:

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

А в социальной сети Вконтакте они размещаются сразу под заметкой:

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

Сообщения добавляются по мере их поступления и сортируются по дате/времени.

Бывает, что комментариев к какому-то материалу становится очень много и часть их переносится на другие станицы:

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

 

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

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

Оставить сообщение к заметке в социальных сетях очень просто – печатаем текст в специальное поле и отправляем.

На сайтах и блогах немного сложнее, но тоже ничего особенного.

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

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

Адрес электронной почты увидит только автор материала – на странице он опубликован не будет.

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

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

Но есть и другие варианты. Например, поставить птичку рядом с надписью «Это не спам»:

Или напечатать в поле сумму двух цифр:

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

Необязательные поля

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

Например, поле «Сайт».

Его заполнять необязательно – это для тех, кто хочет показать автору и читателям адрес своего (личного) сайта.

Или подписка на новые комментарии.

Поставив птичку, на Ваш адрес электронной почты будут приходить письма с уведомлениями о любом оставленном на странице сообщении. Бывает, таких писем приходит очень много, что не всегда удобно.

Как получить ответ на свой комментарий

Ответ придет туда же, где Вы опубликовали свое сообщение. То есть искать его нужно именно на той самой странице.

В социальных сетях это сделать проще. В Одноклассниках, например, есть специальная часть Обсуждения.

А вот на сайтах и блогах дело обстоит хуже. На многих из них комментарии сразу не публикуются.

Как правило, в таких случаях после отправки появляется примерно такое уведомление:

Значит, на этом сайте все оставленные сообщения проверяет администратор или автор (владелец) ресурса. Он читает их и какие-то размещает, а какие-то удаляет.

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

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

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

Автор: Илья Кривошеев

Как писать комментарии? | Техника и Интернет

Что нужно хорошему человеку? Хороший дом, хорошая жена… Так говорил незабываемый Абдулла из культового фильма, но, поскольку я решил добавить в этот перечень некоторые составляющие, то придётся,… уже не выходя из образа, продолжить: «Махмуд, поджигай»!


Оказывается, хорошему человеку, да и просто человеку, крайне необходимо, чтобы о его существовании догадывались окружающие. А как они догадаются, если ты «Войну и мир» не написал, скакать по сцене, как Волочкова, не умеешь, и вообще, с коммуникабельностью полный «швах»?
Можно, конечно, похерить эфемерное понятие «совесть» и податься в политику, но хотя это и не требует особого ума (впрочем, я могу ошибаться), иметь связи и деньги всё-таки необходимо.


Итак, подводим итог: никто вокруг о нас слышать ничего не хочет, видеть нас никто не желает, и всё наше общение ограничивается десятком знакомых, коллег по работе и близких родственников. Разве этого желает наша трепещущая душа?! Нет. Она жаждет простора и общения. Она рвётся сказать этому миру — да! (как говорят экзистенциалисты). Она требует признания даже без призвания, требует, и всё тут. А вот он — Интернет! Пиши, чего хочешь, рисуй, что пожелаешь, а если уж совсем невмоготу, можешь запросто кого-либо послать на все три заветные буквы.


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


Справедливости ради скажу, что иногда встречаешь комментарии, читать которые — одно удовольствие, несмотря на то, что многие из них далеки от панегириков и очень ругательные.


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


Сейчас я изложу несколько простых правил, совершенно не трудных для исполнения, но зато, при их соблюдении, доставляющих такой кайф автору (не адресату), что после небольшой тренировки написание «комментов» может стать для Вас весьма приятным и лёгким занятием.


Правило первое: никогда не пишите комментарий сразу после прочтения материала, который хотели бы прокомментировать.
Я долго искал аллегорию на эту поспешность, которая нужна, как известно, при ловле некоторых насекомых и адюльтере с чужой супругой, и, наконец, нашёл. Звонок в квартиру застаёт Вас на пике оргазма, и вы, подскочив с кровати, отпираете двери и объясняете дежурному электрику его неправоту, помахивая всеми своими неприкрытыми «интимами».
В человеке всё должно быть прекрасно, говорил А. П. Чехов, и он был прав. Так какого дьявола выставлять на всеобщее обозрение непричёсанную физиономию или того хуже — неприкрытую задницу?


Правило второе: не стоит писать «коммент» прямо в окне обозревателя, если ваш браузер — не FireFox.

Напишите в MS Word. Я далёк от того, чтобы становиться в позу грамотея, но правила русской грамматики настолько сложны и запутаны (спросите любого филолога), что лучше довериться программе: по крайней мере, опечатки поправит.


Правило третье, основное: Шопенгауэр сравнивает человека, который ведёт себя невежливо, с полудурком, который копит фальшивые деньги, вместо того чтобы их тратить. В самом деле, вежливость не стоит нам ничего, а взамен приобретается многое — чем не фальшивые доллары?


Повторяю, я далёк от мысли менторствовать и поучать, просто поверьте, что умно написанный комментарий — это как рюмка хорошего коньяка с лимоном. И кислит, и благородно, и на душе теплее.
Славных Вам комментариев, в ответ на Ваши комментарии!

Как писать выделяющиеся комментарии (по правильным причинам)

Комментарии в блогах — это пережиток ушедшей эпохи.

Это уличное слово, не так ли?

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

Но это было тогда, верно?

Сегодня читатели обратились к Facebook, Instagram и YouTube за исправлением комментариев. Спамеры и тролли взяли верх. И в результате некоторые владельцы блогов сделали то, что раньше казалось немыслимым: отключили свои комментарии.

Итак, игра окончена. Блог  Вставьте вилку в них.

Верно?

Не так быстро.

В 2022 году писать хорошие комментарии станет проще, чем когда-либо. Люди это заметят

Умные блоггеры видят возможности там, где другие их не замечают.

Вот правда:

Из-за того, что многие отвергают комментарии в блогах как стратегию распространения информации, конкуренции практически нет.

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

Но в разделе комментариев вы соревнуетесь со сверчками и перекати-полем. А те немногие комментарии, которые существуют, как правило…

Ну, они имеют тенденцию быть отстойными.

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

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

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

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

На самом деле?

Наверное, их комментарии отстой.

Вот почему это проблема:

Неуклюжие комментаторы делают первые свидания ужасными

Комментирование в блогах очень похоже на свидания.

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

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

Комментируя блог, вы пытаетесь завоевать владельца блога.

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

Но возможно ли это, если ваши комментарии отстой?

Конечно, это возможно

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

Но то, что это возможно, не означает, что это вероятно.

Бесплатное обучение: 31 самая прибыльная ниша для блоггеров в 2022 году

Вот почему пришло время улучшить вашу игру в комментировании.

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

Еще лучше: вы можете применить многие из этих советов к комментариям в Facebook, Instagram, Twitter, электронным письмам и т. д.

Давайте углубимся.

Во-первых, мы рассмотрим несколько ошибок новичков, которые саботируют ваши комментарии в блоге. Избегайте их, и вы опередите 90% блоггеров:

Распространенные ошибки, из-за которых комментарии в блогах становятся отстойными

Ошибка №1: Использование нового (или несуществующего) изображения Gravatar

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

Итак, почему вы выбрали изображение Сердитого Кота или Рона Бургунди, чтобы представлять вас в разделе комментариев в блогах людей? Или согласитесь на безликий силуэт, который кричит универсальный никто ?

Вместо этого позвольте людям увидеть вас настоящего.

Они с большей вероятностью почувствуют связь с вами, если увидят ваше лицо.

Кроме того, ты знаешь, что ты сексуальна. Покажи нам эту улыбку!

Подсказка: Если ваше тщательно составленное сообщение каким-то образом помечено фильтрами спама комментариев и помещено в чистилище (т.н. модерация комментариев), граватар увеличивает шансы, что владелец блога одобрит ваш новый комментарий.

Ошибка № 2: Использование вымышленного имени (или «забавного» псевдонима)

Среди ваших друзей и родственников вы можете использовать Lil’ Bit, DJ Roomba, Superfly, House of Shane или любой другой псевдоним по вашему выбору.

Но если вы не шпион или не находитесь под защитой свидетелей, вы должны использовать свое настоящее имя на первом свидании. (Если, конечно, это не свидание вслепую и Гэри Бьюзи не сядет за ваш стол.)

То же самое верно и для комментариев в блогах.

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

Ошибка № 3: Сброс ссылок в ваших комментариях

Хотите, чтобы WordPress, Disqus или любая другая система комментариев знала, что вы не пишете спам-комментарии? Воздержитесь от размещения ссылок в комментариях.

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

Вы пытаетесь отмахнуться, но с вами начинают обсуждать тарифы и правила.

«О нет», — думаете вы. «Это не свидание… это предложение о продаже!»

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

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

Ошибка № 4: Не прочитать сообщение перед комментированием

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

«У тебя есть хобби?» — спросят они, несмотря на тысячу слов в вашем профиле, посвященных папье-маше. «Хотите сочный стейк?» они предложат, несмотря на ваше публично заявленное веганство.

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

Знаете, на что еще нужно время? Вынуть ногу изо рта.

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

Ошибка № 5: Бубнение снова и снова (и снова)

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

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

Или, как я люблю говорить:

«Многословный комментарий в блоге сам по себе защищает себя от риска быть прочитанным».

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

Комментарий из 500 слов не лучше комментария из 100 слов. Обычно это всего в пять раз дольше.

(И, возможно, в пять раз скучнее.)

Ошибка № 6: Повторение только что сказанного в сообщении

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

Вы любите фильмы Кевина Костнера? Как и они.

Вы обожаете мексиканскую кухню? Ага, их тоже.

Ненавидишь понедельники? Они ненавидят понедельники.

Я называю этот вид попугайства (re)Pete Комментарий .

Это не добавляет к разговору. Он не задает вопросов. И это не противоречит идее.

Просто повторяет сказанное в посте.

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

Иначе какой смысл?

4 элемента хорошего комментария в блоге (плюс множество примеров)

  1. Дружеское приветствие
  2. Искренний комплимент
  3. Добавленная стоимость
  4. Прощальное обещание

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

Как начинаются лучшие комментарии? Как они заканчиваются? Что за штука в середине?

Вот основные части, сверху вниз.

Часть №1: Дружеское приветствие

Первое, что я ищу, это персонализация. Это так просто, достаточно просто указать имя автора. Адам Коннелл

Давайте вернемся к нашей аналогии со свиданиями…

Вы встречаете красивого парня или красивую девушку в ресторане на первом свидании. Могут ли они быть тем самым? Они не выглядят сумасшедшими или что-то в этом роде.

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

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

Без предисловий — они сразу начинают рассказывать о своем дне.

Знаете ли вы, что у них есть сотрудник по имени мистер Баттонс? Вы знали, что у них аллергия на арахис?

Вы делаете сейчас.

Памятная дата? Я полагаю.

Дата, с которой вы хотели бы познакомиться поближе? Точно нет.

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

Они думают, что пост написали роботы, а не человек? Считают ли приветствия устаревшим ритуалом? Или им просто лень прокручивать вверх, чтобы найти имя автора?

Если вы надеетесь привлечь внимание блоггеров и завязать отношения, здоровая доза надлежащего этикета может иметь большое значение.

Так передай им привет.

Приветствуйте их.

Обращайтесь к ним по имени.

Как это сделать

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

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

Затем скажите привет . Или привет . Или привет , если вы чувствуете себя по-народному.

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

Время потрачено не зря.

Часть № 2: Искренний комплимент

Приятное подтверждение, когда работа автора оценивается и он может увидеть плоды своего труда. Кэрол Амато

Вы встречаете свою вторую половинку впервые.

«Вау! Мне нравится твой наряд», — можете сказать вы.

Или: «Мне очень нравится твоя машина».

Или даже: «Твоя татуировка Губки Боба великолепна!»

Детали каждый раз разные, но действие одно и то же. Когда вы на свидании, вы делаете другому человеку комплимент. Это то, что вы делаете в цивилизованных обществах.

Опять же, комментарии в блогах ничем не отличаются.

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

Скорее всего, они вам нравятся. Вы цените их. Вы уважаете их.

Так сделайте им комплимент…

Скажите им, как вам понравилась их замечательная статья…

Подарите им день…

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

Как это сделать

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

Вам нравятся работы блоггера? Скажи им так. Скажите, как вам нравится их письмо.

Еще лучше? Расскажите им о конкретном примере, когда их письмо помогло вам.

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

Изменил ли он ваш взгляд на тему? Или, может быть, это побудило вас выйти и действовать? Это потрясло ваш мир?

Скажи им об этом.

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

(Кроме того, вы не хотите показаться жутким преследователем.)

Часть № 3: Добавленная ценность

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

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

Целью каждого вашего комментария должно быть добавление ценности. Если ваш комментарий не добавляет ценности, это пустая трата времени.

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

Что это на самом деле означает?

В данном контексте это означает делать что-то, что заставляет вас казаться ценным — полезным, проницательным, интересным или интересным — для блогера, которого вы хотите привлечь.

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

Вы делаете это, производя положительное впечатление, а затем опираясь на него.

Вот как:

Тактика ценности №1: Делитесь личными наблюдениями или анекдотами

Затронул ли вас какой-то конкретный момент в публикации? Вы нашли что-то особенно близкое? Или пост поднял область, в которой вы боретесь?

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

Вы блоггер со своей историей!

Как это сделать

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

Аманда Формаро отлично демонстрирует это в своем кратком комментарии о подписчиках электронной почты.

В том же обсуждении Дженн устанавливает связь, рассказывая о своей борьбе.

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

Существует множество способов, которыми вы можете поделиться идеями и примерами. Но чем более личным будет ваше понимание, тем более уникальным оно будет.

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

Ценностная тактика № 2: Задавайте вдумчивые вопросы

Была ли представлена ​​в сообщении идея, которую вы не полностью поняли? Может быть, вы хотите, чтобы автор расширил какой-то момент?

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

Вы задаете им вопрос; они отвечают. Это чистая, простая поэзия в движении. И это отличный способ представить себя блогерам, которые вам нравятся.

Как это сделать

Эндрю Уорнер пошел по пути расследования после прочтения анализа посещаемости блога Андриана Пинантоана:

Пуджа, сама по себе превосходный писатель, сделала то же самое, прочитав пост Глена Лонга о кристально чистом письме:

И Гертруда Нонтерах, прочитав мой пост о вехах ведения блога, воспользовалась возможностью задать вопрос, который мучил ее:

Иногда ради краткости автор не будет полностью конкретизировать детали в своем сообщении в блоге.

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

Тактика ценности № 3: Внесите свой вклад в обсуждение

Если вы хотите привлечь внимание влиятельных лиц и владельцев блогов, ваш комментарий должен добавить к разговору. хороший для # 582? Хотите конкретизировать вопрос, обсуждаемый в посте о поиске внештатной писательской работы? Как насчет детали, которая вообще не была освещена?

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

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

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

Блогерам это нравится — и они любят комментаторов, которые помогают это реализовать.

Как это сделать

Прекрасным примером этого является следующий комментарий, который Энн Р. Аллен оставила Брайану Дину в его информационном сообщении для блоггера здесь, на Smart Blogger:

Другой комментарий Харлина Сингх оставила Уиллу Бланту:

И один из лучших примеров, который вы когда-либо видели, — это конкретный комментарий, который Мэтью Хардинг оставил к посту Smart Blogger о вехах ведения блога. Вот фрагмент:

Добавляя ценность хорошим комментарием, вы инвестируете в пост в блоге.

Блогерам это нравится. Они ценят это…

Они учатся на этом…

И помнят об этом.

Часть №4: Прощальное обещание

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

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

Такой подсказкой может быть затянувшаяся улыбка. Это может быть случайное замечание об отсутствии планов на следующую субботу. Или это может быть другой человек, на самом деле говорящий слова: «Мне понравилось, и я хотел бы увидеть вас снова».

Какую бы форму он ни принял, он посылает сообщение: это свидание не было разовым.

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

Вот почему лучшие комментарии обещают в конце. Они говорят блогерам: «Эй… Мне так понравилось, что я хочу, чтобы вечеринка продолжалась!»

Как это сделать

Отличный способ дать обещание — сказать автору, что вы собираетесь поделиться постом в своей любимой социальной сети…

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

Или направить своего внутреннего Арнольда Шварценеггера и сказать им: «Я вернусь» (чтобы узнать больше о вашем контенте)…

Но какое бы обещание вы ни дали, обязательно сдержите его.

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

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

благодарность…

Примеры комментариев в блогах, которые надирают задницу (и дополнительный ингредиент, который они все разделяют)

Так как же выглядит хороший комментарий, в котором есть каждый из этих элементов?

Очень похоже на этот комментарий Эдриенн Смит:

И это очень похоже на комментарий Айодеджи Авосики:

Комментарии Адриенн и Айодеджи начинаются с приветствий, переходят прямо к комплиментам, добавлению ценности и заканчиваются обещаниями.

Но помимо этого, они добавляют дополнительный элемент, присутствующий в большинстве хороших комментариев…

Личность.

Любой робот может начать комментарий с приветствия и закончить его обещанием.

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

Как однажды сказал мне мой друг Джейми Бакли:

«Если вы не будете интересны, мои глаза остекленеют. У всех нас есть личность, но используете ли вы ее? Это видно в ваших комментариях?»

Хайме должен знать. Он мастер показать свою индивидуальность в своих комментариях:

Хайме пишет свои комментарии так же, как электронное письмо другу.

Это освежает и это отличный способ привлечь к себе внимание.

Богатые награды, которые вытекают из тщательно продуманных комментариев

В этот момент вам может быть интересно…

Стоит ли оно того?

Стоит ли тратить все это время и мысли на комментарии в блоге?

Это того стоило.

Много лет назад я оставил следующий комментарий к посту, опубликованному на этом же сайте Smart Blogger:

Я поприветствовал автора по имени, похвалил его работу, добавил ценность и пообещал поделиться его постом сейчас- несуществующий Гугл Плюс.

Неделю спустя, после того как Smart Blogger опубликовал новый пост, я оставил еще один комментарий:

Еще одно приветствие, еще один комплимент, еще одна добавленная стоимость и еще одно обещание.

На следующей неделе я сделал это снова:

И снова на следующей неделе. И следующее. Снова и снова, снова и снова.

Каждую неделю, неделя за неделей, я посещал Smart Blogger, читал их последний шедевр и оставлял хороший комментарий.

Тогдашний редактор Smart Blogger, Глен Лонг, обратил внимание:

Несколько месяцев спустя Глен пригласил меня стать приглашенным автором:

Это приглашение привело к моему первому посту для Smart Блогер…

…что привело к еще нескольким.

Перенесемся на несколько лет вперед, и Джон Морроу, генеральный директор компании, пригласил меня присоединиться к Smart Blogger в качестве главного редактора.

Сегодня я веду блог, которым восхищаюсь и за которым следил столько лет. Я работаю вместе со своими наставниками Джоном и Гленом. Я могу исполнить свою мечту: бросить крысиные бега и полностью посвятить себя ведению блога.

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

Ваш пробег может и будет варьироваться.

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

Давайте узнаем, куда вас могут завести хорошие комментарии

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

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

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

Они способны заставить влиятельных блоггеров сесть, обратить внимание и спросить себя: «Кто это ?

Итак, вы готовы к новой эре умного комментирования?

Готовы узнать, к чему могут привести хорошие комментарии?

Тогда давайте сделаем это.

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

Вставьте эту инфографику на свой сайт:

com» width=»700 px» class=»noa3lazy»/>
Как писать комментарии, которые выделяются (по правильным причинам) на SmartBlogger.com

Руководство инженера по написанию осмысленного кода Комментарии

«Что это делает?»

«Почему это не билет?»

Были там? Если вы чем-то похожи на большинство инженеров, можно с уверенностью сказать, что это случается с вами очень часто .

Наиболее очевидное и непосредственное преимущество написания хороших комментариев заключается в том, что они облегчают понимание кода другими.

Но когда мы отрабатываем лучшие практики комментирования кода (в том числе когда и , когда , а не для написания комментариев), мы можем открыть еще более важные и долгосрочные преимущества, такие как:

  • повышение скорости разработки
  • улучшение качества кода

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

В этом полном руководстве по написанию осмысленных комментариев к коду мы:

  • Объясним, какие существуют типы комментариев
  • Обсудим, когда и как писать комментарии к коду
  • Расскажем о некоторых передовых методах комментирования кода
  • Обсудим, когда не их писать (а что делать вместо этого!)

Стоит ли вообще использовать комментарии?

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

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

Типы комментариев (и когда их использовать)

1. Контекстные комментарии

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

Первый тип — это комментарии на уровне модуля. Они описывают назначение классов, функций и методов.

Эти комментарии могут включать… 

  • Параметры, которые принимает функция
  • Результат, который она генерирует
  • Любые функции модуля, которые нельзя понять с первого взгляда.

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

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

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

Когда их использовать: 

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

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

Меньшее количество комментариев часто означает более читаемый код. Если кто-то увидит комментарий, он поймет, что он острый и ценный.

Когда их следует избегать: 

  • Когда назначение функции очевидно
  • В библиотеках или API-интерфейсах
  • Когда это должно быть отмечено как проблема. (Вот как команды погребают под кучей технических долгов, даже не подозревая об этом.)

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

Инженерная практика, которую должна принять ваша команда, заключается в последовательном документировании ненужного сложного кода как задач. Это позволяет избежать накопления серьезного технического долга, который может быть трудно погасить. Если вы еще не используете для этого инструмент, попробуйте Jira или Linear для отслеживания проблем на основе приложений. Или попробуйте Stepsize для отслеживания технического долга и управления им из редактора кода.

2. TODO/FIXME

TODO и FIXME повсюду. Но они сопряжены со значительными затратами.

TODO — отличный инструмент для одиночной игры… Они отлично подходят для временного сброса мыслей, чтобы вы могли сосредоточиться на том, что делаете. TODO определенно лучше, чем список сбоку, потому что у них есть контекст.

Но ужасный многопользовательский инструмент . Когда TODO попадают в `main`, вы получаете бесконечный, невидимый список невыполненных работ , который не подлежит действию.

Плохая практика комментариев — прямой путь к растущему техническому долгу и снижению качества кода.

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

Если в вашей кодовой базе есть TODO, используйте инструмент управления задачами Stepsize, чтобы преобразовать их в задачи, не выходя из IDE. Инструмент также будет отображать TODO в PR, где вы можете превратить их в задачи.

Три передовых метода написания комментариев к коду

1. Сосредоточьтесь на

почему

Лучшие комментарии к коду — те, которые вам не нужны . Лучшие комментарии нельзя заменить кодом.

Взгляните на этот пример, который мы заимствовали у Джефа Раскина:

/* Бинарный поиск оказался медленнее, чем алгоритм Бойера-Мура для интересующих наборов данных, поэтому мы использовали более сложный, но более быстрый метод, хотя эта проблема на первый взгляд не кажется поддающейся решению с помощью метода строкового поиска. */

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

Код говорит вам как . Комментарии говорят вам , почему .

2.

Не навязывайте TODO. Создавайте проблемы.

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

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

Используйте такой инструмент, как Stepsize, чтобы управлять проблемами, не выходя из базы кода. Stepsize интегрируется с такими платформами, как Jira и Linear, если вы этого хотите. Расширение VSCode находится здесь, а расширение Jetbrains — здесь. Этот инструмент позволит вам:

  • Преобразовывать TODO в задачи одним щелчком
  • Отмечайте TODO и проблемы в PR
  • Визуализируйте проблемы и технический долг в различных частях вашей кодовой базы
  • Сделайте управление проблемами простым для инженеров
  • Станьте героем технического долга!
Такие инструменты, как Stepsize, могут очищать TODO и управлять проблемами

3.

Выберите и задокументируйте соглашения.

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

Возможно, вы программируете на языке с помощью инструмента для компиляции документов, такого как Javadoc для Java, godoc для Go! Или Doxygen для C++. Используйте их — хотя они и не идеальны, структурные преимущества перевешивают недостатки.

Выбирайте инструменты и методы решения проблем, интуитивно понятные для отдельных инженеров и приносящие пользу команде. Вы запрещаете TODO в `main` или у вас есть политика документирования проблем? Убедитесь, что это все понимают.

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

Закрепление ваших принципов приносит свои плоды, когда инженеры присоединяются к вашей команде или покидают ее.

Округление

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

Когда мы делаем это правильно, мы не просто облегчаем понимание другим. Мы:

  • Ускорение разработки
  • Улучшение качества кода
  • Повышение морального духа команды
  • Управление техническим долгом 730002 Во-первых, когда мы пишем хорошие комментарии, мы постоянно выявляем важную информацию об особенностях кода и архитектурных решениях.

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

Оставить комментарий

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

Ваш адрес email не будет опубликован. Обязательные поля помечены *