Лингвофорум

Цитата: Python от декабря 13, 2018, 00:09
Для меня комментарии — преимущественно часть «разработки сверху вниз». Т.е., вначале пишу комментарий, что мне нужно сделать, далее под ним по пунктам расписываю последовательность действий, как это сделать — каждое действие либо в виде комментария, либо в виде инструкций программы, и т.д., пока все пункты и подпункты не обретут свой программный код. Чтобы отличить расшифрованные пункты от нерасшифрованных, нерасшифрованные заканчиваю многоточием (обычно 4 или больше точки вконце), расшифрованные — двоеточием (либо, если расшифровка выглядит проще и понятнее, чем ее описание в комментарии, просто заменяю комментарий кодом).

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

Цитата: From_Odessa от декабря 13, 2018, 01:17
Да, но имею небольшой опыт Однако согласен, что он у меня настолько незначительный, что Ваши слова тут гораздо более значимы (или же мои вообще не имеют значения). Мой опыт актуален, вероятно, для сроком типа пары месяцев, но точно не для пары лет.

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

Цитата: Easyskanker от декабря 13, 2018, 08:10
Я только хотел заметить, что не всегда уместно сопровождать чужие сообщения своими возражениями

Вам показалось, это не было возражение. Наверное, я выбрал неудачную форму для выражения мысли, прошу за это прощения. Я просто делился своим предположением, в том числе, чтобы детализировать Ваше мнение. Конечно, мой опыт в программировании слишком маленький, чтобы судить о двух годах. Потому я исхожу из того, что Вы правы, и через пару лет даже с комментариями в своём коде сложно разобраться Я могу судить о месяце-двух. Без комментариев я уже после такого срока не то, чтобы путался, но вынужден был немного подумать, зачем я писал ту или иную вещь. Наш преподаватель программирования в моём первом ВУЗе, бывший, кажется, на тот момент программистом с где-то 30-летним стажем, подчеркивал, что без комментариев можно и через месяц не все понять у себя в программе, а потому они нужны не только для других программистов, но и для себя. А я ощутил его правоту )

Easyskanker, кстати, если не секрет, скажите, пожалуйста: программист - Ваша основная работа? Вот Вы говорили, как ездите на работу - это Вы как раз туда ездите, где программируете?

Да.

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

Цитата: Easyskanker от декабря 13, 2018, 08:31
Да.

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

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

@Easyskanker

А нынешняя работа Вам как? Как Вам программирование вообще?

Кстати, Вы всегда работаете в офисе (или в чем-то вроде этого) или иногда удаленно?

Удаленно в том числе. Нынешняя нравится.

Цитата: Easyskanker от декабря 13, 2018, 09:14
Нынешняя нравится.

Это здорово

Спасибо.

Цитата: Easyskanker от декабря 12, 2018, 11:14

Цитата: Hellerick от Как будто в собственном коде двухлетней давности заблудиться трудно.

Даже с комментариями.

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

Цитата: Bhudh от декабря 12, 2018, 12:44
Я даже в коде полугодовой давности когда копаюсь, часто жалею, что не добавил лишний комментарий.

Цитата: Python от декабря 13, 2018, 00:09
Для меня комментарии — преимущественно часть «разработки сверху вниз». Т.е., вначале пишу комментарий, что мне нужно сделать, далее под ним по пунктам расписываю последовательность действий, как это сделать — каждое действие либо в виде комментария, либо в виде инструкций программы, и т.д., пока все пункты и подпункты не обретут свой программный код.

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

Цитата: From_Odessa от декабря 13, 2018, 08:17

Цитата: Easyskanker от Я только хотел заметить, что не всегда уместно сопровождать чужие сообщения своими возражениями

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

Я не увидел там возражения.

Цитата: mnashe от декабря 13, 2018, 12:06

Цитата: From_Odessa от декабря 13, 2018, 08:17
Вам показалось, это не было возражение. Наверное, я выбрал неудачную форму для выражения мысли, прошу за это прощения. Я просто делился своим предположением, в том числе, чтобы детализировать Ваше мнение.

Я не увидел там возражения.

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

Хороший код в комментариях не нуждается.

Вы комментарии с документацией не путаете?

Цитата: wandrien от декабря 13, 2018, 14:16
Хороший код в комментариях не нуждается.

Ровно до тех пор, пока вам не приходится вернуться к своему коду через год-два...

Цитата: wandrien от декабря 13, 2018, 14:16Хороший код в комментариях не нуждается.

Это в котором имена переменных на полстрочки (и имена классов на две)?

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

Цитата: Bhudh от декабря 13, 2018, 14:59
Это в котором имена переменных на полстрочки (и имена классов на две)?

Ага.

Цитата: Awwal12 от декабря 13, 2018, 14:59

Цитата: wandrien от декабря 13, 2018, 14:16
Хороший код в комментариях не нуждается.

Ровно до тех пор, пока вам не приходится вернуться к своему коду через год-два...

Постоянно приходится.

Цитата: Bhudh от декабря 13, 2018, 14:59

Цитата: wandrien от декабря 13, 2018, 14:16Хороший код в комментариях не нуждается.

Это в котором имена переменных на полстрочки (и имена классов на две)?

Видимо, по-вашему так лучше, и так на весь экран строчек:

int a; /* очень очень длинное описание очень очень нужной переменной */


Кто-нибудь пытался по-русски переменные называть?

Цитата: Hellerick от декабря 13, 2018, 15:09
Кто-нибудь пытался по-русски переменные называть?

У меня порой вклинивается русский (у отца это, естественно, был вообще основной метод). Но англоязычные удобнее как минимум в силу большей краткости (какая-нибудь "bigpagesleft" соответствовала бы совершенно монструозной русскоязычной конструкции в три десятка букв, и даже при перефразировании - не меньше 20 букв).

Цитата: Hellerick от декабря 13, 2018, 15:09Кто-нибудь пытался по-русски переменные называть?

/** Задания **/
$.испечь=$.cookie;
function положить_печенье(печенье, тесто){
$.испечь(печенье, тесто, { path: '/' });
return тесто;
}
function взять_печенье(печенье, тесто){
var в_чашке=$.испечь(печенье);
if(тесто!=неопределено){
if(!в_чашке){
в_чашке=положить_печенье(печенье, тесто);
};
};
return в_чашке;
}

function выбрать_занятие(занятие){
положить_печенье('_занятие', занятие);
}

function узнать_занятие(занятие){
return взять_печенье('_занятие', занятие);
}

function сохранить_работу(работа){
if(работа==неопределено){
return $.испечь('_работа');
}else{
return положить_печенье('_работа', работа);
};
}

function Идём_в_(место){
location.href=место;
}

Цитата: Hellerick от декабря 13, 2018, 15:03
Я комментариев оставляю мало. В основном там, где чувствую, что нечто в коде требует запоминания.
Обычно полагаюсь на говорящие названия переменных.

Но таки нередко потом кусаю локти, что не прокомментировал.

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