Оглавление:
- Введение
- Переменные
- Функции
- Классы
- Объекты и структуры данных. Асинхронность. Обработка ошибок.
- Тестирование. Форматирование. Комментарии.
Инженерные принципы программного обеспечения, из книги Роберта С. Мартина «Clean code», приспособленные для JavaScript.
Это не стайл гайд. Это руководство по написанию читаемого, переиспользуемого и поддерживаемого кода на javascript. Не каждый принцип здесь, должен строго соблюдаться. Это принципы и ничего больше, но они сформированы в течение многих лет коллективного опыта авторами clean code.
Нашему ремеслу инженерии программного обеспечения чуть больше 50 лет и все ещё много чему учимся. Когда программная архитектура станет стара как сама архитектура, может быть, тогда мы будем иметь более жесткие правила, которым необходимо будет следовать. На данный момент, пусть эти принципы служат камнем преткновения, с помощью которого вы будете оценивать качество кода JavaScript, который пишете вы и ваша команда.
Еще одна вещь: знание этих принципов не сделает вас сразу лучшим разработчиком программного обеспечения, и если вы будете придерживаться этих принципов много лет не означает, что вы не будете делать ошибки. Каждый фрагмент кода начинается как черновик, как и кусок мокрой глины который приобретает свою окончатильную форму. Наконец, мы исправляем недостатки, когда рассматриваем код с своими коллегами. Не корите себя при первых набросках кода, которые нуждаются в улучшении. Улучшайте свой код вместо этого.
Комментарии (7)
sshikov
14.01.2017 15:16+3>пусть эти принципы служат камнем преткновения, с помощью которого вы будете оценивать качество кода JavaScript
Что вы имели в виду? Обычно под камнем преткновения понимается совсем другое что-то. Ровно противоположное. КП — это препятствие на пути, если уж совсем просто.
TheShock
15.01.2017 02:02+5Не стоит выкладывать статьи на два абзаца. Если есть интересный материал — лучше скомпоновать в статью достаточного размера и выложить за один раз
AndreyRubankov
17.01.2017 21:40Все это уже не раз обсуждалось и разжевывалось, зачем еще раз? JS не так сильно отличается от других языков, для которых уже сотни статей было. Да и для js было сотня статей уже.
ps: Мне кажется, Вы нарушаете авторское право, публикуя ссылку пиратскую копию книги Р. Мартина.
Я понимаю, что плевать хотелось, но все же, не нужно так.
BoryaMogila
17.01.2017 22:10Согласен уберу. А перевод ради практики и более глубокого понемания смысла принципов. Как говрится повторение мать учения
lair
Эм. Книга Clean Code написана Робертом "Дядюшка Боб" Мартином. То, что вы переводите — это набор принципов из этой книги, адаптированный под JS:
BoryaMogila
Раян Макдермотт адаприровал и назвал свою адаптацию clean-code-javascript. Я подразумевал именно её.
lair
Является ли его адаптация книгой? Нет.