better es6 modules, fixes

iliakan · iliakan · commit 2fcf9414f068 · 2015-10-18T15:10:09.000+03:00
diff --git a/1-js/10-es-modern/13-modules/article.md b/1-js/10-es-modern/13-modules/article.md
@@ -38,25 +38,29 @@
 <li>отдельно, при этом в фигурных скобках указывается, что именно экспортируется.</li>
 </ul> 
 
-Например:
+Например, так экспортируется переменная `one`:
 
 ```js
 // экспорт прямо перед объявлением
 export let one = 1;
+```
+
+Можно написать `export` и отдельно от объявления:
 
-// можно и раздельно, в две строки вместо одной
+```js
 let two = 2;
+
 export {two};
 ```
 
-Заметим, что в фигурных скобках указывается не блок, не произвольное выражение, а только имя.
+При этом в фигурных скобках указываются одна или несколько экспортируемых переменных.
 
-Можно указать несколько:
+Для двух переменных будет так:
 ```js
 export {one, two};
 ```
 
-Также можно указать, что переменная `one` будет доступна снаружи под именем `once`, а `two` -- под именем `twice`:
+При помощи ключевого слова `as` можно указать, что переменная `one` будет доступна снаружи (экспортирована) под именем `once`, а `two` -- под именем `twice`:
 
 ```js
 export {one as once, two as twice};
@@ -74,9 +78,11 @@ export function sayHi() {
   alert("Hello!");
 };
 
-// или export {User, sayHi}
+// отдельно от объявлений было бы так:
+// export {User, sayHi}
 ```
 
+[smart header="Для экспорта обязательно нужно имя"]
 Заметим, что и у функции и у класса при таком экспорте должно быть имя.
 
 Так будет ошибка:
@@ -85,6 +91,9 @@ export function sayHi() {
 export function() { alert("Error"); };
 ```
 
+В экспорте указываются именно имена, а не произвольные выражения.
+[/smart]
+
 ## import
 
 Другие модули могут подключать экспортированные значения при помощи ключевого слова `import`.
@@ -136,19 +145,18 @@ alert( `${item1} and ${item2}` ); // 1 and 2
 import * as numbers from "./nums";
 */!*
 
+// теперь экспортированные переменные - свойства numbers
 alert( `${numbers.one} and ${numbers.two}` ); // 1 and 2 
 ```
 [/smart]
 
 ## export default
 
-Выше мы видели, что модуль может экспортировать произвольное количество значений при помощи `export`. 
-
-Однако, как правило, код стараются организовать так, чтобы каждый модуль делал одну вещь. Иначе говоря, "один файл -- одна сущность, которую он описывает".
+Выше мы видели, что модуль может экспортировать выбранные переменные при помощи `export`. 
 
-Например, файл `user.js` содержит `class User`, файл `login.js` -- функцию `login()` для авторизации, и т.п. 
+Однако, как правило, код стараются организовать так, чтобы каждый модуль делал одну вещь. Иначе говоря, "один файл -- одна сущность, которую он описывает". Например, файл `user.js` содержит `class User`, файл `login.js` -- функцию `login()` для авторизации, и т.п. 
 
-При этом модули, разумеется, будут взаимосвязаны. Например, `login.js`, скорее всего, будет импортировать класс `User` из модуля `user.js`.
+При этом модули, разумеется, будут использовать друг друга. Например, `login.js`, скорее всего, будет импортировать класс `User` из модуля `user.js`.
 
 Для такой ситуации, когда один модуль экспортирует одно значение, предусмотрено особое ключевое сочетание `export default`.
 
@@ -174,21 +182,66 @@ import User from './user';
 new User("Вася");
 ```
 
-Если бы в `user.js` не было `default`, то в `login.js` необходимо было бы указать фигурные скобки:
+"Экспорт по умолчанию" -- своего рода "синтаксический сахар". Можно было бы и без него, импортировать значение обычным образом через фигурные скобки `{…}`. Если бы в `user.js` не было `default`, то в `login.js` необходимо было бы указать фигурные скобки:
 
 ```js
-// если в бы user.js не было default: 
+// если бы user.js содержал
 // export class User { ... }
 
-// …то при импорте понадобились бы фигурные скобки:
+// …то при импорте User понадобились бы фигурные скобки:
 import {User} from './user';
 
 new User("Вася");
 ```
 
-Как видно, "экспорт по умолчанию" -- лишь небольшой синтаксический сахар. Можно было бы и без него, импортировать значение обычным образом через фигурные скобки `{…}`.
+На практике этот "сахар" весьма приятен, так как позволяет легко видеть, какое именно значение экспортирует модуль, а также обойтись без лишних символов при импорте.
+
+## CommonJS
+
+Если вы раньше работали с Node.JS или использовали систему сборки в синтаксисе CommonJS, то вот соответствия.
+
+
+Для экспрта по умолчанию вместо:
+```js
+module.exports = VARIABLE;
+```
+
+Пишем:
+```js
+export default VARIABLE;
+```
+
+А при импорте из такого модуля вместо:
+
+```js
+let VARIABLE = require('./file');
+```
+
+Пишем:
+
+```js
+import VARIABLE from './file';
+```
+
+Для экспорта нескольких значений из модуля, вместо:
+
+```js
+exports.NAME = VARIABLE;
+```
+
+Пишем в фигурных скобках, что надо экспортировать и под каким именем (без `as`, если имя совпадает):
+
+```js
+export {VARIABLE as NAME};
+```
+
+При импорте -- также фигурные скобки:
+
+```js
+import {NAME} from './file';
+```
+
 
-Но на практике этот "сахар" весьма приятен, так как позволяет легко видеть, какое именно значение экспортирует модуль, а также обойтись без лишних символов при импорте.
 
 ## Использование
 
diff --git a/1-js/5-functions-closures/1-global-object/article.md b/1-js/5-functions-closures/1-global-object/article.md
@@ -21,7 +21,7 @@
 Например:
 
 ```js
-//+ run untrusted refresh
+//+ run untrusted refresh no-strict
 var a = 5; // объявление var создаёт свойство window.a
 alert( window.a ); // 5
 ```
