up

Author: iliakan

1-js/03-code-quality/05-testing/3-pow-test-wrong/solution.md

@@ -1,8 +1,12 @@
-Этот тест демонстрирует один из соблазнов, которые ожидают начинающего автора тестов.
+The test demonstrates one of temptations a developer meets when writing tests.
 
-Вместо того, чтобы написать три различных теста, он изложил их в виде одного потока вычислений, с несколькими `assert`.
+What we have here is actually 3 tests, but layed out as a single function with 3 asserts.
 
-Иногда так написать легче и проще, однако при ошибке в тесте гораздо менее очевидно, что же пошло не так.
+Sometimes it's easier to write this way, but if an error occurs, it's much less obvious what went wrong.
+
+If an error happens inside a complex execution flow, then we'll have to figure out what was the data at that point.
+
+TODO
 
 Если в сложном тесте произошла ошибка где-то посередине потока вычислений, то придётся выяснять, какие конкретно были входные и выходные данные на этот момент, то есть по сути -- отлаживать код самого теста.
 

1-js/03-code-quality/05-testing/3-pow-test-wrong/task.md

@@ -2,23 +2,23 @@ importance: 5
 
 ---
 
-# Что не так в тесте?
+# What's wrong in the test?
 
-Что не так в этом тесте функции `pow`?
+What's wrong in the test of `pow` below?
 
 ```js
-it("Возводит x в степень n", function() {
-  var x = 5;
+it("Raises x to the power n", function() {
+  let x = 5;
 
-  var result = x;
+  let result = x;
   assert.equal(pow(x, 1), result);
 
-  var result *= x;
+  result *= x;
   assert.equal(pow(x, 2), result);
 
-  var result *= x;
+  result *= x;
   assert.equal(pow(x, 3), result);
 });
 ```
 
-P.S. Синтаксически он верен и работает, но спроектирован неправильно.
+P.S. Syntactically it's correct and passes.

1-js/04-object-basics/06-constructor-new/1-two-functions-one-object/solution.md

@@ -1,18 +1,14 @@
-Да, возможны.
+Yes, it's possible.
 
-Они должны возвращать одинаковый объект. При этом если функция возвращает объект, то `this` не используется.
+If a function returns an object then `new` returns it instead of `this`.
 
-Например, они могут вернуть один и тот же объект `obj`, определённый снаружи:
+So thay can, for instance, return the same externally defined object `obj`:
 
 ```js run no-beautify
-var obj = {};
+let obj = {};
 
 function A() { return obj; }
 function B() { return obj; }
 
-var a = new A;
-var b = new B;
-
-alert( a == b ); // true
+alert( new A() == new B() ); // true
 ```
-

1-js/04-object-basics/06-constructor-new/1-two-functions-one-object/task.md

@@ -2,9 +2,9 @@ importance: 2
 
 ---
 
-# Две функции один объект
+# Two functions -- one object
 
-Возможны ли такие функции `A` и `B` в примере ниже, что соответствующие объекты `a,b` равны (см. код ниже)?
+Is it possible to create functions `A` and `B` such as `new A()==new B()`?
 
 ```js no-beautify
 function A() { ... }
@@ -16,4 +16,4 @@ var b = new B;
 alert( a == b ); // true
 ```
 
-Если да -- приведите пример кода с такими функциями.
+If it is, then provide an example of their code.

1-js/04-object-basics/06-constructor-new/2-calculator-constructor/_js.view/test.js

@@ -1,25 +1,25 @@
-sinon.stub(window, "prompt")
-
-prompt.onCall(0).returns("2");
-prompt.onCall(1).returns("3");
 
 describe("calculator", function() {
-  var calculator;
+  let calculator;
   before(function() {
+    sinon.stub(window, "prompt")
+
+    prompt.onCall(0).returns("2");
+    prompt.onCall(1).returns("3");
+
     calculator = new Calculator();
     calculator.read();
   });
 
-  it("при вводе 2 и 3 сумма равна 5", function() {
+  it("when 2 and 3 are entered, the sum is 5", function() {
     assert.equal(calculator.sum(), 5);
   });
 
-  it("при вводе 2 и 3 произведение равно 6", function() {
+  it("when 2 and 3 are entered, the product is 6", function() {
     assert.equal(calculator.mul(), 6);
   });
 
+  after(function() {
+    prompt.restore();
+  });
 });
-
-after(function() {
-  prompt.restore();
-});

1-js/04-object-basics/06-constructor-new/2-calculator-constructor/solution.md

@@ -17,10 +17,9 @@ function Calculator() {
   };
 }
 
-var calculator = new Calculator();
+let calculator = new Calculator();
 calculator.read();
 
-alert( "Сумма=" + calculator.sum() );
-alert( "Произведение=" + calculator.mul() );
+alert( "Sum=" + calculator.sum() );
+alert( "Mul=" + calculator.mul() );
 ```
-

1-js/04-object-basics/06-constructor-new/2-calculator-constructor/task.md

@@ -2,23 +2,22 @@ importance: 5
 
 ---
 
-# Создать Calculator при помощи конструктора
+# Create new Calculator
 
-Напишите *функцию-конструктор* `Calculator`, которая создает объект с тремя методами:
+Create a constructor function `Calculator` that creates objects with 3 methods:
 
-- Метод `read()` запрашивает два значения при помощи `prompt` и запоминает их в свойствах объекта.
-- Метод `sum()` возвращает сумму запомненных свойств.
-- Метод `mul()` возвращает произведение запомненных свойств.
+- `read()` asks for two values using `prompt` and remembers them in object properties.
+- `sum()` returns the sum of these properties.
+- `mul()` returns the multiplication product of these properties.
 
-Пример использования:
+For instance:
 
 ```js
-var calculator = new Calculator();
+let calculator = new Calculator();
 calculator.read();
 
-alert( "Сумма=" + calculator.sum() );
-alert( "Произведение=" + calculator.mul() );
+alert( "Sum=" + calculator.sum() );
+alert( "Mul=" + calculator.mul() );
 ```
 
 [demo]
-

1-js/04-object-basics/06-constructor-new/3-accumulator/_js.view/solution.js

@@ -2,7 +2,7 @@ function Accumulator(startingValue) {
   this.value = startingValue;
 
   this.read = function() {
-    this.value += +prompt('Сколько добавлять будем?', 0);
+    this.value += +prompt('How much to add?', 0);
   };
 
-}
+}

1-js/04-object-basics/06-constructor-new/3-accumulator/_js.view/test.js

@@ -1,8 +1,4 @@
-describe("Accumulator(1)", function() {
-  var accumulator;
-  before(function() {
-    accumulator = new Accumulator(1);
-  });
+describe("Accumulator", function() {
 
   beforeEach(function() {
     sinon.stub(window, "prompt")
@@ -12,26 +8,23 @@ describe("Accumulator(1)", function() {
     prompt.restore();
   });
 
-  it("начальное значение 1", function() {
+  it("initial value is the argument of the constructor", function() {
+    let accumulator = new Accumulator(1);
+
     assert.equal(accumulator.value, 1);
   });
 
-  it("после ввода 0 значение 1", function() {
+  it("after reading 0, the value is 1", function() {
+    let accumulator = new Accumulator(1);
     prompt.returns("0");
     accumulator.read();
     assert.equal(accumulator.value, 1);
   });
 
-  it("после ввода 1 значение 2", function() {
+  it("after reading 1, the value is 2", function() {
+    let accumulator = new Accumulator(1);
     prompt.returns("1");
     accumulator.read();
     assert.equal(accumulator.value, 2);
   });
-
-  it("после ввода 2 значение 4", function() {
-    prompt.returns("2");
-    accumulator.read();
-    assert.equal(accumulator.value, 4);
-  });
-
-});
+});

1-js/04-object-basics/06-constructor-new/3-accumulator/solution.md

@@ -5,14 +5,13 @@ function Accumulator(startingValue) {
   this.value = startingValue;
 
   this.read = function() {
-    this.value += +prompt('Сколько добавлять будем?', 0);
+    this.value += +prompt('How much to add?', 0);
   };
 
 }
 
-var accumulator = new Accumulator(1);
+let accumulator = new Accumulator(1);
 accumulator.read();
 accumulator.read();
-alert( accumulator.value );
+alert(accumulator.value);
 ```
-