Добрый день, товарищи разработчики!

Пару месяцев назад начал осваивать специализацию Fullstack-разработчика и, спустя какое-то время, как любой приличный разработчик, стал искать руководства по стилю для JavaScript. В результате, это привело… к переводу одного из них, о чем я и хочу рассказать в этой статье.

---

ESList подсказал мне, что на данный момент есть три основные руководства:

• Google JS Style Guide ^[1]
• AirBnb Style Guide ^[2]
• JS Standard ^[3]

AirBnb без проблем прочитал на русском, так как первым увидел именно перевод (спасибо за перевод компании Uprock, которая уже писала об этом на Хабре — пост ^[4]). Руководство JS Standard довольно короткое и без проблем читается на английском.

Однако именно руководство по стилю от Google оказалось самым объемным и исчерпывающим (особенно порадовал раздел про документирование), но, в то же время, самым тяжелым в плане чтения в оригинале. Написано довольно сухо, иногда сложными конструкциями и некоторые моменты приходилось перечитывать по несколько раз, чтобы точно понять смысл.

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

Поэтому делюсь с вами ссылкой на перевод — Google JS Style Guide на русском ^[5], и искренне надеюсь, что кому-то это упростит жизнь.

P.S. В случае, если в переводе есть неточности или недостаточно тонко отражены некоторые моменты, я и разработчики, которые буду его читать — будем благодарны за pull request'ы с дополнениямиулучшениями!

Автор: RostislavDugin

Источник ^[6]