fe051
diff --git a/‎docs/integration-tests.md‎
Lines changed: 13 additions & 17 deletions b/‎docs/integration-tests.md‎
Lines changed: 13 additions & 17 deletions
diff --git a/‎docs/screenshots/cypress-runner.png‎
-69.6 KB b/‎docs/screenshots/cypress-runner.png‎
-69.6 KB
@@ -1,10 +1,10 @@
 ## Integration Tests
 
-Debugger.html integration test are end-to-end tests that simulate a user debugging an application.
+![](./screenshots/cypress-runner.png)
 
-The tests open two browser tabs, the debuggee and debugger, and go through the steps of debugging the debuggee.
+The integration tests open two browser tabs, debuggee and debugger, and go through the debugging steps.
 
-Here's one test that pauses while creating a Todo.
+Here's one test that debugs todomvc:
 
 ```js
 debugPage("todomvc");
@@ -18,26 +18,27 @@ stepOver();
 stepOut();
 ```
 
-#### Helpful Information
-+ `public/js/test/integration` - tests folder
-+ `public/js/test/cypress/commands` - test commands folder
+The tests are driven with javascript [events](https://developer.mozilla.org/en-US/docs/Web/API/Document/createEvent)
+like click, keypress, or change that simulate a user interacting with the debugger. All of the events are wrapped with
+debugger specific commands like `stepIn` or `selectSource` [commands](https://github.com/jlongster/debugger.html/blob/master/public/js/test/cypress/commands/debugger.js#L110-L112).
 
 #### Running tests
 + `npm run firefox` - launch firefox
 + `cypress run` - runs tests headlessly
 + `cypress open` - opens cypress app
++ `public/js/test/integration` - tests folder
++ `public/js/test/cypress/commands` - test commands folder
+
 
-**Installing Cypress**
-Cypress needs to be installed before tests can be run.
+### Installing Cypress
 
 ```bash
 npm install -g cypress-cli
 cypress install
 ```
 
-[More Information](https://docs.cypress.io/docs/installing-and-running)
-
-Notes:
+**Notes:**
++ [Install Steps](https://docs.cypress.io/docs/installing-and-running)
 + It's helpful to close the firefox debugger in other tabs as it might cause the tests to miss a firefox message.
 + You can also test chrome by opening chrome and enabling the chrome test in `todomvc.js`.
 
@@ -63,12 +64,7 @@ We use Cypress to generate the fixtures that are used in the unit tests and stor
 + `public/js/test/integration/fixtures.js` - fixtures file
 + `public/js/test/fixtures` - Fixture folder
 
-Steps:
+**Steps:**
 + start the cypress server to save the fixtures - `node bin/cypress-server`
 + enable the fixture tests - change `xdescribe` to `describe` in [fixtures.js](../public/js/test/integration/fixtures.js).
 + run cypress - `cypress run`
-
-
-#### Screenshots
-
-![](./screenshots/cypress-runner.png)