Рубрика «комментарии» - 4

Речевая агрессия в интернете или Как послать, чтобы не вернулся? - 1

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

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

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

Все животные равны, но некоторые животные равнее других. Скотный Двор, Джордж Оруэлл (оригинал).

Достаточно много статей на хабре набирает существенное количество комментариев, e.g. в статьях "лучшее за месяц" их, как правило, более сотни. За годы чтения хабра, создалось впечатление, что примерно в половине случаев для комментариев первого уровня получается вот такая вот картина
Не все комментарии одинаково полезны
(картинка сделана на основе хабра-статьи Список скептика)

Под катом рассказ, какие бывают сортировки комментариев, где они применяются и краткое рассуждение о том, как вообще можно сортировать комментарии (и зачем).
Читать полностью »

Меня давно интересует тема комментирования кода. Этот пост подвиг меня формализовать свою идеологию документирования кода.

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

imageВ последнее время, набирает популярность мысль, что комментарии в коде — дело не обязательное, и даже вредное. Буквально вчера вечером, общаясь со знакомым молодым программистом, попросившим посмотреть его код, я обнаружил, что комменты отсутствовали вовсе, даже привычные описания методов. На мой удивленный смайлик, был ответ: “Комментарии — первый признак плохого кода”. И черт бы с ним, с начинающим программистом, но я периодически читаю что-то похожее в блогах, и слышу от коллег. Может программирование в очередной раз сделало шаг вперед, а я, среди отстающих? Под катом, немного размышлений, о том, когда и почему стоит или не стоит комментировать свой код.
Читать полностью »

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

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

В первое время комментарии через Google+ будут показываться параллельно с обычными комментариями только в некоторых видеороликах. Но до конца текущего года опция станет доступна для всех видео.
Читать полностью »

Quick Help научился брать документацию из комментариев:

Quick Help для своего кода в XCode 5
Читать полностью »

На StackOverflow был отличный пост точно на эту тему, но какой-то сверхусердный модератор, который должен остаться неназванным, удалил его (судя по всему, сейчас восстановлено — прим. пер.).

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

// 
// Дорогой мейнтейнер:
// 
// Когда ты закончишь «оптимизировать» эту подпрограмму
// и поймешь, насколько большой ошибкой было делать это,
// пожалуйста, увеличь счетчик внизу как предупреждение
// для следующего парня:
// 
// total_hours_wasted_here = 42
//

Читать полностью »

image
Этот пост будет совсем коротким. В общем-то, одного заголовка достаточно для того, чтобы догадаться, о чём я хочу сказать.

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

Если это кажется вам банальным, просто прокрутите страницу дальше :)
Читать полностью »

Появился пост, в комментариях к которому (какая ирония) было много мнений,
что самый лучший код — self-documenting и все такое.

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

Кто желает подискутировать — прошу к столу под кат.
Читать полностью »


https://ajax.googleapis.com/ajax/libs/jquery/3.4.1/jquery.min.js