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

Если Вы или другие разработчики не считали Завершенный Код (или Код, Завершенный 2 ) все же тогда, останавливают то, что Вы делаете и читаете его.

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

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

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

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

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

, который стоит принять во внимание также, что многие хорошие разработчики очень предпочитают писать, хрустящий картофель чистит C#, Java, безотносительно, чем намного менее точные естественные языки со всеми предположениями и неоднозначностями, которые они имеют. Верный большинство людей со здравым смыслом знало бы, сколько детали является достаточным количеством детали, но хорошие разработчики не являются 'большинством людей'. Вот почему мы заканчиваем с комментариями как \\adds a to b and store it in c (хорошо, это - также экстремальное значение, но Вы понимаете).

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