Выпиливает всю сборку, оставляет только статику #13

juwain · 2017-04-21T15:50:34Z

No description provided.

…е практики в коде

meritt · 2017-05-26T12:39:45Z

Изометрия на фоне сломалась.

…e/js-codeguide

o0

Еще где-то видел забытую инструкцию ESLint и вообще надо причесать. Я займусь!

o0 · 2017-07-10T10:20:18Z

index.html

+        <ul>
+          <li>
+            <a href="html-css.html">
+              <img src="img/logo-html.svg" alt="Логотип HTML">


o0 · 2017-07-10T10:21:09Z

index.html

+          </li>
+          <li>
+            <a href="javascript.html">
+              <img src="img/logo-js.svg" alt="Логотип JavaScript">


JavaScript? Это же нужно для читалок, прикинь человек останавливается на ссылке, которая ведет на гайд по JS, а читалка ему «логотип JS»

Что-то мне стало казаться, что надо вообще выкинуть эту страницу. Будет две страницы: кодгайд по HTML/CSS и по Javascript. С обеих страниц будут ссылки друг на друга. Получается разводящей страницы не нужно (по крайней мере пока кодгайдов не стало много).

Не знаю, я б оставил;)

o0 · 2017-07-10T10:34:37Z

javascript.html

+              <li>Внутри строки не используется более одного пробела.</li>
+
+              <li>Открывающие скобки блоков кода находятся на одной строке с оператором, которых их использует:<pre class="language-js"><code>
+- if (condition)


Ну, я использовал diff из-за встроенной подсветки зелененьким и красненьким. Если у нас получилось что мы просто используем синтаксис js и ---, +++, то я переделаю на блоки с разным цветом.

Я добавлю для diff стили, оказалось, что их нет по умолчанию.

Не, не надо, я тут подумал, что JS с разным фоном будет лучше. Diff хак

o0 · 2017-07-10T10:35:38Z

javascript.html

+
+              <li>В операторе <code>switch</code> запрещено дублировать условия (case)</li>
+
+              <h4>Массивы</h4>


Ой 🙊 Надо что-то сюда написать или убрать заголовок.

o0 · 2017-07-18T10:22:23Z

@zeckson читани пожалуйста файл javascript.html? Это расшифровка конфига ESLInt. Надо уже катить, сколько лет ждем;) Я хочу добавить еще строчку про приоритет версий, что желательно использовать ES6, но если совсем плохо с поддержкой, то можно ES5.

zeckson · 2017-07-18T13:00:12Z

Надо md закилять или синхронизировать

o0 · 2017-07-18T14:00:33Z

Закилято!

zeckson · 2017-07-19T13:32:26Z

md/syntax.md

@@ -0,0 +1,218 @@
+# Стиль кода JS


Почему это не удалено?

Потому что это то, что будет основной версией.

Не понял. А остальные md? Или о чем это? Это что-то другое?

zeckson · 2017-07-19T13:32:42Z

md/syntax.md

+
+## Форматирование
+### Строка не должна быть длиннее 80 символов
+Строки более 80 символов длиной, снижают скорость чтения заставляя читатаеля


Пруф или не было!

Оке, я поищу

zeckson · 2017-07-19T13:33:12Z

md/syntax.md

+в разного рода презентациях, что увеличивает требования к читаемости кода
+
+### Выравнивание знаков равенства запрещено
+Трудоемкий и очень хрупкий процесс. Если хотя бы одна из переменных


Если хотя бы одна из переменных что? Аааааа!!! Интрига!

Тут надо просто показать пример.

А дописать предложение? Например, давайте разберем на примере: — нельзя же так обрывать предложение на пол-фразе

zeckson · 2017-07-19T13:37:36Z

md/syntax.md

+     }, true);
+```
+
+#### Аргументы функций и вызовы через цепчку отделяются четырьмя пробелами


У нас в eslint двумя. Настало время определиться:

'indent': ['error', 2, { SwitchCase: 1, // continuation indent VariableDeclarator: 1, // indent is multiplier * indent = 1 * 2 MemberExpression: 2, // indent is multiplier * indent = 1 * 2 FunctionDeclaration: {parameters: 2}, FunctionExpression: {parameters: 2}, CallExpression: {arguments: 2} }],

Как тебе нравится?

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

zeckson · 2017-07-19T13:38:25Z

md/syntax.md

+     'base-class--collapsed', this.isCollapsed())} />
+```
+
+#### Альтернативный способ переносить аргументы — выравнивать их с открывающей скобкой


Хмммм...

Java-Java.

Автореформаттеры ломают такой способ

zeckson · 2017-07-19T13:40:22Z

md/syntax.md

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


последняя и после сортировки и удаления нужно перепроверить получившийся список на валидность.

это про что?

я когда писал так ощущал, а теперь не думаю вообще, что перенос точки проблема. Даже грешным делом начал подумывать удалить и разрешить все это безобразие. Как ты думаешь?

zeckson · 2017-07-19T13:41:21Z

md/syntax.md

+     template.chilren[0].cloneNode(true);
+```
+
+## Правила языка


Уточнить — для ES без модулей

zeckson · 2017-07-19T13:43:39Z

md/syntax.md

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


Мне кажется это лишнее для стайлгайда. Это же не методическое пособие.

Мне кажется, что почему бы и нет.

Ну тогда добавь такие пояснения везде. Почему так выборочно?

zeckson · 2017-07-19T13:45:05Z

md/syntax.md

+ }
+```
+
+### Замыкания


Это чё?

zeckson · 2017-07-19T13:46:51Z

Очень плохой пулл-реквест — в нём свалено всё и изменения и рефакторинги и правки и черт в ступе. Пожалуйста не делайте так. Никакого хорошего ревью не получится

zeckson · 2017-07-19T13:47:23Z

Я хочу добавить еще строчку про приоритет версий, что желательно использовать ES6, но если совсем плохо с поддержкой, то можно ES5.

Давай не будет добавлять такую строчку.

meritt · 2017-07-19T13:47:56Z

Я согласен с @zeckson. Сейчас это не вмёржить уже. Можно было сделать ветку от этой ветки.

o0 · 2017-07-19T13:51:00Z

Ну если только по тексту то надо было обсуждать в другой ветке, это уже версия, которую @juwain готовит к публикации. Может быть да, можно было сделать в несколько шагов, но сейчас уже PR какой есть, надо что-то делать. Ок, плохо, выход какой? Никаких альтернатив не предложено. Повздыхали и разошлись.

o0 · 2017-07-19T13:52:02Z

Давай не будет добавлять такую строчку.

Аргументы и альтернатива. Давай не добавлять такую строку ~~потому что это ложь~~, а вместо этого лучше ~~напьемся~~

zeckson · 2017-07-19T13:50:35Z

javascript.html

+
+              <li>Блоки кода отделяются друг от друга не более чем двумя пустыми строками</li>
+
+              <li>В качестве символа строки используется стандартный символ, который используется в системе</li>


Это чё?

EOL. LF/CRLF и вот это все.

Тогда нужно написать в качестве символа переноса строки

zeckson · 2017-07-19T13:51:42Z

javascript.html

+
+              <li>В блоках кода первая и последняя строка не должны быть пустыми (код не отбивается от начала блока кода)</li>
+
+              <li>После двоеточий и точек с запятым ставятся пробелы. Перед ними — не ставятся.</li>


Где-то есть точки в конце, где-то нет — лучше определиться

Долой точки в конце

zeckson · 2017-07-19T13:52:39Z

javascript.html

+
+              <li>При объявлении вычисляемых ключей в объектах с помощью синтаксиса ES2016 в квадратных скобках не используются пробелы</li>
+
+              <li>Оператор вызова функции () не отделяется круглыми скобками от названия функции</li>


Имется ввиду вот это: (callFun)()

Забыл вопрос задать =)
Имется ввиду вот это: (callFun)()?

zeckson · 2017-07-19T13:55:09Z

javascript.html

+
+              <li>Перед скобками начинающими новый блок кода должен ставиться пробел.</li>
+
+              <li>при объявлении анонимных функций, скобки с параметрами ставятся непосредственно после ключевого слова function. Если функция именована, перед названием ставится пробел, после — нет.</li>


С большой буквы

В нашем eslint это не так.

@zeckson давай договоримся, что если ты что-то отрицаешь, то ты делаешь противопоставление, так удобней. Да, я мог ошибиться, но я не в контексте. Будет конструктивней, если ты напишешь: у нас не так, а вот так.

@o0 хорошо, у нас вот так:

'space-before-function-paren': ['error', {named: 'never', anonymous: 'always'}],

zeckson · 2017-07-19T13:56:23Z

javascript.html

+
+              <li>В spread-операторе точки не отделяются от названия коллекции</li>
+
+              <li>Звездочка после ключевого слова yield не отбивается пробелом. После звездочки проблел ставится всегда.</li>


проблел

zeckson · 2017-07-19T14:18:27Z

javascript.html

+
+        <article class="chapter-part">
+          <div class="chapter-part-col chapter-part-col--full-width">
+            <h3 id="">Неиспользуемый код</h3>


Закомментированный код?

Ну про закомментированный код или это не сюда?

Не, про закомментированный код у нас нет ничего в этом гайде. ESLint же не умеет его проверять.

zeckson · 2017-07-19T14:19:15Z

javascript.html

+            </ul>
+
+            <ul>
+              <li>В конструкции <code>try..catch</code> запрещен пустой блок <code>try</code></li>


Пустой блок catch

htmlacademy/eslint-config-htmlacademy#12

zeckson · 2017-07-19T14:20:28Z

javascript.html

+            <ul>
+              <li>При итерировании по объектам через <code>for..in</code> при работе со свойствами используется конструкция <code>hasOwnProperty</code></li>
+
+              <li>В функциях не используются обращения к <code>caller</code> и <code>callee</code></li>


Перенести в запрещенное

Где у нас запрещенное?

344 строка https://github.com/htmlacademy/codeguide/pull/13/files/ea43097679bd6bf15812174a0234da38e2c79c9b#diff-7796c0b9f39eb4152e44c90da7a2ca9eR344

zeckson · 2017-07-19T14:20:47Z

javascript.html

+        <article class="chapter-part">
+          <div class="chapter-part-col chapter-part-col--full-width">
+            <ul>
+              <li>При итерировании по объектам через <code>for..in</code> при работе со свойствами используется конструкция <code>hasOwnProperty</code></li>


for..in не используется

Правило?

увы в eslint нет такого правила, но я бы запретил совсем

zeckson · 2017-07-19T14:21:59Z

javascript.html

+<pre class="language-js language-correct"><code>const result = 2;
+</code></pre>
+<br>
+<pre class="language-js language-incorrect"><code>switch (val = getVal(), val) {}


это и так запрещено выше

Потерял контекст

нельзя присваивать и использовать одновременно

Это немного не то!

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

zeckson · 2017-07-19T14:25:50Z

Аргументы и альтернатива. Давай не добавлять такую строку потому что это ложь, а вместо этого лучше напьемся

Без аргументов и альтернативы, просто предложение. Т.к. добавление такой строки приведет к дальнейшему бесконечному рефакторингу многочисленных мест.
Альтернативно я бы просто сделал сноску напротив всех пунктов где есть раздвоение, например ES2015 и выше

zeckson · 2017-07-19T14:35:04Z

Ок, плохо, выход какой? Никаких альтернатив не предложено. Повздыхали и разошлись.

Я отревьюил как смог, но html форматирование мешает сосредоточиться на тексте к сожалению. Формат html плохо подходит для редактуры на мой взгляд. Плюс он не подразумевает модульности

o0 · 2017-07-19T14:36:04Z

@zeckson согласен.

…ения

zeckson · 2017-08-01T13:16:24Z

javascript.html

            <h3 id="">Операторы</h3>
-            <ul>
-              <li>В конструкторе классов-наследников обязательно вызывается <code>super()</code></li>
+            <p>В конструкторе классов-наследников обязательно вызывается <code>super()</code></p>


Я повторю свой вопрос — нужно ли дублировать синтаксические ошибки в стайлгайде?

Хотя ладно, пусть будет

zeckson · 2017-08-01T13:16:29Z

javascript.html


-              <li>В конструкторе нет обращения к <code>this</code> до того, как будет вызван <code>super()</code></li>
-            </ul>
+            <p>В конструкторе нет обращения к <code>this</code> до того, как будет вызван <code>super()</code></p>


Я повторю свой вопрос — нужно ли дублировать синтаксические ошибки в стайлгайде?

Хотя ладно, пусть будет

Правило ESLint! Тулза проверяет, хороший ли синтаксис, у них есть такие правила, например проверка валидности регулярки. Если регулярка невалидна, то код упадет, но ESLint не позволяет до этого дойти, так что, я считаю, что это хорошо.

o0 and others added 17 commits December 21, 2015 02:32

Начальная версия MD кодгайда

c091bc6

Добавляет структуру для JS кодгайда. Группирует правила из ESLint

bbd2589

Добавляет текст правил форматирования кода

e1ee94a

Расширяет правила форматирования кода

94bc2f1

Добавляет правила по именованию

beb375c

Добавляет правила помогающие избежать распространенных ошибок

cfd3e9b

Добавляет правила помогающие избежать ошибок в условных операторах

1ee8d98

Добавляет правила про использование функции

9ce441e

Добавляет правила про классы

a5b9e2c

Добавляет правила про переменные

a85a8f9

Добавляет правила про использование функций

9a5b3f1

Добавляет правила про избежание ошибок при создании новых значений

93e4dc7

Добавляет правила, рекомендующие использовать распространенные хороши…

e22a612

…е практики в коде

Добавляет правила, запрещающие манкипатчинг

db7c0d8

Добавляет правила, запрещающие манипуляции с контекстом

2aa4bd7

Добавляет правило, запрещающее удаление переменных через delete

7a39053

Выпиливает всю сборку, сотавляет только статику

dfce0b9

juwain added the status: wip label Apr 21, 2017

juwain self-assigned this Apr 21, 2017

juwain added 3 commits April 24, 2017 16:54

Правит одно и правил

d63e7b9

Правит устаревшую инфу в ридми

aca8be8

Добавляет разметку главной страницы

6dbdbc6

juwain requested a review from meritt April 25, 2017 09:23

juwain added status: review needed and removed status: wip labels Apr 25, 2017

o0 added 2 commits May 2, 2017 19:19

Добавляет последние тексты для правил

2407cc0

Исправляет фактическую ошибку в объяснении правила

1d71b2e

meritt approved these changes May 26, 2017

View reviewed changes

Merge branch 'master' of github.com:htmlacademy/codeguide into featur…

f4acfb1

…e/js-codeguide

juwain added 4 commits July 7, 2017 18:16

Складирует md отдельно, удаляет лишнее

4557aa6

Добавляет черновое оформление кодгайда js

113f181

РАсставляет теги code

fbce775

Стилизует страницу

d1d6a32

juwain mentioned this pull request Jul 10, 2017

Добавить кодгайд по JS #14

Closed

juwain requested a review from o0 July 10, 2017 09:52

o0 suggested changes Jul 10, 2017

View reviewed changes

Добавляет новые стили для кода: правильный и неправильный код.

14cebde

Удаляет MD

ea43097

zeckson suggested changes Jul 19, 2017

View reviewed changes

o0 added 4 commits July 27, 2017 19:11

Добавляет в JS основные правки по код-ревью

098083d

Добавляет форматирование кода

5066238

Исправляет кавычки на елочки в гайде JS

eae5e62

Исправляет в кодгайде JS списки на абзацы и добавляет небольшие измен…

8f59338

…ения

zeckson reviewed Aug 1, 2017

View reviewed changes

zeckson approved these changes Aug 1, 2017

View reviewed changes

o0 merged commit 290487b into master Aug 1, 2017

juwain deleted the feature/total-destructuration branch August 23, 2017 09:38


		<li>В операторе <code>switch</code> запрещено дублировать условия (case)</li>

		<h4>Массивы</h4>


		<li>Блоки кода отделяются друг от друга не более чем двумя пустыми строками</li>

		<li>В качестве символа строки используется стандартный символ, который используется в системе</li>


		<li>В блоках кода первая и последняя строка не должны быть пустыми (код не отбивается от начала блока кода)</li>

		<li>После двоеточий и точек с запятым ставятся пробелы. Перед ними — не ставятся.</li>


		<li>При объявлении вычисляемых ключей в объектах с помощью синтаксиса ES2016 в квадратных скобках не используются пробелы</li>

		<li>Оператор вызова функции () не отделяется круглыми скобками от названия функции</li>


		<li>Перед скобками начинающими новый блок кода должен ставиться пробел.</li>

		<li>при объявлении анонимных функций, скобки с параметрами ставятся непосредственно после ключевого слова function. Если функция именована, перед названием ставится пробел, после — нет.</li>


		<li>В spread-операторе точки не отделяются от названия коллекции</li>

		<li>Звездочка после ключевого слова yield не отбивается пробелом. После звездочки проблел ставится всегда.</li>

Выпиливает всю сборку, оставляет только статику #13

Выпиливает всю сборку, оставляет только статику #13

Uh oh!

Conversation

juwain commented Apr 21, 2017

Uh oh!

meritt commented May 26, 2017

Uh oh!

o0 left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

juwain Jul 10, 2017 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

o0 commented Jul 18, 2017

Uh oh!

zeckson commented Jul 18, 2017

Uh oh!

o0 commented Jul 18, 2017

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

zeckson commented Jul 19, 2017

juwain Jul 10, 2017 •

edited

Loading