Вопросы с тегом «standards»

75
Есть ли смысл включать «журнал изменений» в каждый файл кода, когда вы используете контроль версий?

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

73
Должны ли имена интерфейсов начинаться с префикса «I»?

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

72
Что ХХХ означает в комментарии? [закрыто]

Что люди обычно имеют в виду, когда вы видите XXXв комментарии. Иногда я увижу такой комментарий: # XXX - This widget really should frobulate the whatsit Конечно, я могу сказать, что означает комментарий, но что обычно означает XXX? Это говорит "Это взлом" или, может быть, "Мы должны вернуться к...

71
Почему бы вам не использовать директиву using в C #?

Существующие стандарты кодирования в большом проекте C # включают правило, согласно которому все имена типов должны быть полностью квалифицированными, что запрещает использование директивы using. Итак, а не знакомые using System.Collections.Generic; .... other stuff .... List<string> myList =...

68
Проблемы с именами: следует ли переименовать «ISomething» в «Something»? [закрыто]

В главе «Дядя Боб» об именах в « Чистом коде» рекомендуется избегать кодировок в именах, главным образом в отношении венгерских обозначений. Он также особо упоминает удаление Iпрефикса из интерфейсов, но не показывает примеров этого. Давайте предположим следующее: Использование интерфейса в...

64
Почему знак минус «-», как правило, не перегружается так же, как знак плюс?

Знак плюс +используется для сложения и конкатенации строк, но его компаньон: знак минус -, как правило, не виден для обрезки строк или какого-либо другого случая, кроме вычитания. В чем может быть причина или ограничения для этого? Рассмотрим следующий пример в JavaScript: var a = "abcdefg"; var b...

64
Почему загадочные короткие идентификаторы все еще так распространены в низкоуровневом программировании?

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

63
Являются ли комментарии от первого лица отвлекающими и непрофессиональными?

Я просто обнаружил, что пишу следующий комментарий в некотором (архаичном Visual Basic 6.0) коде, который я писал: If WindowState <> 1 Then 'The form's not minimized, so we can resize it safely '... End if Я не уверен, почему я подсознательно использую «мы» в моих комментариях. Я подозреваю,...

60
Работа над чужим кодом [закрыто]

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

53
Соглашения о присвоении имен протоколу Swift [закрыто]

Исходя из в основном фона c #, я привык использовать термин «интерфейс» для описания объекта без реализации, определяющей поведение. В c # соглашение заключается в добавлении имен интерфейсов с помощью «I», например IEnumerable, и т. Д. Конечно, у концепции разные названия на разных языках. В Swift...

49
if ('constant' == $ variable) против if ($ variable == 'constant')

В последнее время я много работал над PHP и, в частности, в рамках WordPress. Я замечаю много кода в виде: if ( 1 == $options['postlink'] ) Где бы я ожидал увидеть: if ( $options['postlink'] == 1 ) Это соглашение встречается в определенных языках / структурах? Есть ли какая-либо причина, по которой...

47
Почему #include <iostream.h> плохо?

Я читал другую ветку, где парень спрашивал о книгах по С ++ для начинающих, и один из отвечавших программистов написал это: Некоторые предупреждения: избегайте всех книг, которые представляют «привет мир» с #include <iostream.h> Я открыл свою книгу по C ++ и, конечно же, включил заголовок...

44
Что доказано как хорошая максимальная длина функции? [закрыто]

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

43
Является ли использование имен параметров, которые отличаются от имен типов только регистром, плохой практикой в ​​C #?

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

42
Что определяет надежный код?

Мой профессор продолжает ссылаться на этот пример Java, когда говорит о «надежном» коде: if (var == true) { ... } else if (var == false) { ... } else { ... } Он утверждает, что «надежный код» означает, что ваша программа учитывает все возможности, и что не существует такой вещи, как ошибка - все...

41
Нужно ли добавлять регистр по умолчанию при использовании коммутаторов?

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

41
Является ли JS Boolean с пользовательскими свойствами плохой практикой?

В JS вы можете вернуть логическое значение, имеющее пользовательские свойства. Например. когда Modernizr проверяет поддержку видео, он возвращает trueили, falseно возвращенное логическое значение (Bool является объектом первого класса в JS), имеет свойства, определяющие, какие форматы...

40
Работа со стандартами кодирования на работе (я не начальник)

Я работаю в небольшой команде, около 10 разработчиков. У нас вообще нет стандартов кодирования. Есть определенные вещи, которые стали нормой, но некоторые способы ведения дел совершенно разные. Мой большой - отступ. Некоторые используют вкладки, некоторые используют пробелы, другие используют...