Improve chapter 08.

Author: tfrommen

08 - Testing/01 - Writing Tests.php

@@ -12,8 +12,8 @@
 
 // 1. Create a new PHPUnit test file. From the navigation bar, create a new file using the PHPUnit template.
 //    Note that another way of creating a test is to use the Go to Test navigation:
-//      - Navigate to the Queue class
-//      - Use the Go to Test navigation to either go to test or create a new test
+//      - Navigate to the Queue class.
+//      - Use the Go to Test navigation to either go to test or create a new test.
 //
 // 2. For Fully Qualified name, search for the Queue class.
 //    All other parameters for the unit test class can be kept at their defaults.
@@ -25,11 +25,10 @@
 //
 //    }
 //
-// 3. Add a function called setUp() which sets up a new Queue in a new field called $_queue;
+// 3. Add a function called setUp() which sets up a new Queue in a new field called $_queue;.
 //    To generate the setUp() function, we can use the Generate | Override method action (Alt+Insert / Command+N).
 //
 //    This is what the class should look like:
-//    (note: the Code | Comment With Line Comment menu may be handy if you are copy/pasting the below code)
 //
 //   class QueueTest extends \PHPUnit_Framework_TestCase {
 //       /** @var Queue */
@@ -40,7 +39,9 @@
 //       }
 //   }
 //
-// 4. Add a first test, verifying the enqueue() method. This can be done using Alt+Insert / Command+N
+//    Note: the Code | Comment With Line Comment menu may be handy if you are copy/pasting the above code.
+//
+// 4. Add a first test, verifying the enqueue() method. This can be done using Alt+Insert / Command+N.
 //
 //  public function testEnqueueIncreasesItemCount() {
 //      $this->_queue->enqueue('test');

08 - Testing/03 - Test Driven Development.php

@@ -25,7 +25,7 @@
 //
 //    In other words: if items are in queue, peek() should return true. It should return false if no items are in queue.
 //
-// 2. PhpStorm displays an inspection on the peek() method: Method peek() not found in class Queue
+// 2. PhpStorm displays an inspection on the peek() method: Method peek() not found in class Queue.
 //    Using Alt+Enter, create the method.
 //    Implement the method.
 // 3. Run unit tests and see tests are all passing.

08 - Testing/04 - Code Coverage.php

@@ -8,6 +8,6 @@
 namespace Testing\JetBrains;
 
 // 1. Run the unit tests created earlier with Code Coverage enabled.
-//    This can be done using the "Run tests with Coverage" action (try Search Everywhere or the toolbar)
+//    This can be done using the "Run tests with Coverage" action (try Search Everywhere or the toolbar).
 // 2. Explore code coverage results from the Code Coverage tool window.
 //    Using F4 or double-clicking, navigate to Queue.php and see which lines of code are tested and which ones are not.

08 - Testing/05 - JavaScript testing.js

@@ -2,19 +2,19 @@
  * JavaScript Unit Testing (using Karma)
  */
 
-// 1. Install the Karma plugin (IDE Settings | Plugins)
+// 1. Install the Karma plugin (IDE Settings | Plugins).
 // 2. Install the Karma test runner on your system using NPM:
 //      npm install -g karma
 //      (or use Project Settings | Node.js and NPM, search Karma and add the -g install option)
 // 3. Make sure a Karma configuration is created. Either rename karma.conf.js.sample to karma.conf.js or set it up manually.
 //
-//    Manual steps: Open a terminal (Tools | Open Terminal) and initialize karma in the current folder
+//    Manual steps: Open a terminal (Tools | Open Terminal) and initialize karma in the current folder.
 //      cd "08 - Testing"
 //      karma init
 //
-//    - Select the test framework to use, we'll go with jasmine
-//    - Select "no" on using Require.js
-//    - Select the browser to capture
+//    - Select the test framework to use, we'll go with jasmine.
+//    - Select "no" on using Require.js.
+//    - Select the browser to capture.
 //    - For test location, enter *.js so Karma will run all tests in the current folder.
 //    - For excluding files, leave an empty string. More info can be found in the Karma documentation.
 //    - For automatically running, select "no". When enabled, this will automatically run unit tests whenever