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

в 14:30, , рубрики: исходный код, комментарии, ненормальное программирование, Программирование, юмор

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

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

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

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

в 21:16, , рубрики: junior, комментарии, невидимый тег, Программирование, холивар, метки: , , ,

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

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

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

в 18:00, , рубрики: документирование, комментарии, Программирование, метки: ,

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

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

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

в 6:12, , рубрики: комментарии, Программирование, разработка, Совершенный код, метки: ,

Комментировать или не комментировать?По-настоящему хороший комментарий — тот,
без которого вам удалось обойтись.
© Дядюшка Боб

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

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

в 12:54, , рубрики: комментарии, Программирование, философия, метки: ,

Вступление

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

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

Для понимания проблемы обратимся к Вики, а после перейдем к примерам:

Коммента́рии — пояснения к исходному тексту программы, находящиеся непосредственно внутри комментируемого кода.

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

в 7:16, , рубрики: Cackle, Блог компании Cackle, выплаты, деньги, комментарии, я пиарюсь, метки: , , , ,

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

в 6:24, , рубрики: Cackle, disqus, Блог компании Cackle, веб-аналитика, виджет, виджет комментариев, комментарии, система комментирования, социальные сети, статистика интернета, я пиарюсь, метки: , , , , , , , , ,

Cackle — итоги года

В октябре 2011 года на просторах интернета появился уникальный к тому времени проект Cackle. Это был первый в мире проект с более чем 18 провайдерами авторизации, включая все основные Российские социальные сети. По итогам года мы решили провести анализ работы системы, собрали занимательные факты и статистические данные о социальных комментариях.
Читать полностью »

в 9:35, , рубрики: Cackle, disqus, Facebook, веб-дизайн, Веб-разработка, Вконтакте, комментарии, система комментирования, социальные сети, Социальные сети и сообщества, метки: , , , , , ,

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

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

в 7:39, , рубрики: android, Google Play, комментарии, Разработка под android, метки: , ,

Разработчики получили возможность отвечать на комментарии пользователей в Google Play.
Читать полностью »

в 18:16, , рубрики: disqus, Facebook API, feedback, без регистрации и смс, виджеты сайтов, Вконтакте API, комментарии, регистрация, метки: , , , , , , ,

Напомню: andorro 19 декабря прошлого года поведал нам о том, что некоторые сайтостроители экономят усилия, воздерживаясь от создания собственной системы комментариев. Для такой экономии на сайте размещаются готовые виджеты, предназначенные для оставления комментариев участниками социальной сети Facebook, или ВКонтакте, или Disqus. Иногда сразу нескольких сетей. Читателям это также повадно: не надо возёхаться, залогиниваясь на сайте, ведь им достаточно быть залогиненными в «своей» социальной сети.

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

На днях я обнаружил и другой недостаток:

[not logged in]

И вот как это произошло.

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

1...456
Главная   |  Архив новостей  |   Android  |   Google  |   Apple  |   Microsoft  |   Информационная безопасность  |   Веб – разработка
Публикации RSS  |  Комментарии RSS
https://ajax.googleapis.com/ajax/libs/jquery/3.4.1/jquery.min.js