Публикации по тегам clean-code

Публикации по теме 'clean-code'

Лучшие практики для комментариев в коде

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

Чистый код в Aumni

Я присоединился к Aumni после того, как обнаружил, что технический директор, Роб Уайз, был чистым программистом на 10/10, который любил структуру и тесты. Это было дополнительно подкреплено тем, что Роб был вторым самым активным участником Prettier-Atom — инструмента, который почти в одиночку помог мне преодолеть дислексию при обучении программированию. Я чувствовал, что созданная структура и практика дзен помогут мне работать на более высоком уровне эффективности, уверенности и..

Документация в защиту ленивого кода

Когда я был младшим программистом, я стремился принять любой совет, который мог получить. Вот один, который у меня есть довольно много: Всегда документируйте свой код, чтобы другие могли его понять. Это даже всплывало в вопросах интервью: Интервьюер: Когда вы должны документировать свой код? Я: Всякий раз, когда непонятно? Интервьюер: На самом деле мы документируем каждую строчку нашего кода. Me: Oh. На первый взгляд, это хороший совет. Конечно, мы хотим, чтобы..

Python — язык с динамической типизацией, а это значит, что мы не определяем тип объекта, но…

Python — язык с динамической типизацией, что означает, что мы не определяем тип объекта, но это не значит, что мы не можем объявлять типы как форму аннотаций ради документирования нашего кода. Документы Python называют это подсказками типов . Смотри документы здесь . Иногда при анализе данных и построении/оценке моделей машинного обучения в блокноте Jupyter мы заканчиваем тем, что пишем функции, чтобы сэкономить время и нервы. Ведь зачем писать (var1 + var2 + var3 + var4 + var5)..

3 метрики кода, которые должен знать каждый разработчик

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

Хотите более чистый код? Используйте правило шести

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