Есть ли какая-нибудь книга про оформление кода?

Мне нужна книга про оформление кода, чтобы я мог писать код как программисты крутых компаний. То есть знать, где отступы ставить, когда надо писать с новой строки, когда надо писать с самого начала строки, а когда лучше сделать несколько отступов и т.д.
P.S. Веб-дизайн.
  • Вопрос задан
  • 3666 просмотров
Пригласить эксперта
Ответы на вопрос 8
delphinpro
@delphinpro
frontend developer
Шаг первый: Покупаем лицензию на phpStorm

Шаг второй: Ковыряем настройки
5d598fcbc189a286363026.png

Шаг третий: Форматируем свой код автоматически нажатием клавиш или через пункт меню.
5d599006b36c6873044335.png

Профит: Получаем код, будто его написали "программисты крутых компаний".
Эх, если бы код от этого реально становился крутым =))
Ответ написан
samodum
@samodum
Смотришь чужой хороший код и пишешь так же.
Ещё это называется "Code convention", внутри каждой команды он может быть свой, либо вообще отсутствовать
Ответ написан
@EvgeniiR
https://github.com/EvgeniiR
Тоесть знать где отступы ставить, когда надо писать с новой строки, когда надо писать с самого начала строки, а когда лучше сделать несколько отступов и тп.

В Совершенном Коде от Макконнела затрагиваются даже такие темы. Можете почитать.

Но вообще - эти вещи решаются на уровне команды - как всем будет проще и удобнее, контроллируются автоматическими скриптами анализирующими код стайл, и приводятся к нужному код стайлу одним вызовом скрипта или кнопокой "Reformat" в IDE.

Мне нужна книга про оформление кода, чтобы я мог писать код как программисты крутых компаний.

Нет никакого смысла пытаться делать "как Гугл".
Это вовсе не сколь-либо значимые вещи во первых, и во вторых у Гугла другие расклады и другие проблемы, потому пытаться копировать поведение "разработчиков из крутых компаний" без какого-либо анализа затея очень так себе.
Ответ написан
Griboks
@Griboks
1. Всегда везде используете табы.
2. Каждый блок выносите в функцию.
3. В заголовке файла пишите глобальные переменные.
5. Всегда коммитте clrf.
6. И побольше комментариев. Желательно, чтобы их было больше самого кода. А то ничего не понятно будет.
Ответ написан
@nvdfxx
Senior Pomidor developer
eslint+airbnb(например) и плохой код (со стороны визуальный составляющей) написать не получиться
Ответ написан
GreyCrew
@GreyCrew
Full-stack developer
Станные вещи говорит автор Developer.
Во многих книгах есть разделы, посвященные оформлению кода.
К примеру Мартин Чистый код
Либо, Макконнелл Совершенный код (мне она больше понравилась)

Единственное, что не надо воспринимать их, как абсолют, это все же больше пища для ума. И надо уметь применять разные практики в разных местах.
Ответ написан
@alekseyHunter
Студент. Охотник за знаниями.
Griboks, вы, видимо, или мало писали код, или пришли пошутить.

1. Всегда нужны табы только в питоне, т.к. он просто код не интерпретирует. В функциональном программировании можно выполнить 50% заданий в 1 строчку через точку.

2. Блок выносится в функцию, если он повторяется. А если он повторяется, значит есть ошибка в архитектуре.
Функция должна выполнять только 1 задачу, не затрагивать внешних переменных и иметь значимое имя.

3. Глобальные переменные - зло. Один программист изменяет значение, другой думает, что значение первоначальное, лезет туда, а там уже совсем другое.

5. Комментарий нужен только как пояснение логики, т.е. в сложных функциях. А если и писать, то согласно тому же Javadoc.

Кому будет полезно читать "Метод проверяет данные и возвращает true/false", когда правильно подобранное имя функции или переменной уже все объясняет.

После многочисленных правок кода, комментарий не будет соответствовать содержанию.
Ответ написан
Ваш ответ на вопрос

Войдите, чтобы написать ответ

Войти через центр авторизации
Похожие вопросы
IT IS Kernel Новосибирск
от 100 000 руб.
First Line Outsourcing Краснодар
от 45 000 до 100 000 руб.
16 сент. 2019, в 19:16
50000 руб./за проект
16 сент. 2019, в 18:39
2000 руб./за проект
16 сент. 2019, в 18:30
3000 руб./за проект