remove duplicated content that is present on the developer page, instead link to that page

1 files changed, 3 insertions, 185 deletions

diff --git a/tests/README.screenshots.md b/tests/README.screenshots.md
index 8769dc738b..da3f7fd7a3 100644
--- a/tests/README.screenshots.md
+++ b/tests/README.screenshots.md
@@ -1,9 +1,10 @@
 # Screenshots UI tests
 
 Piwik contains UI tests that compare captured screenshots of URLs and UI controls with expected screenshots.
-If a captured screenshot does not match its expected screenshot, the build will fail.
+If a captured screenshot does not match its expected screenshot, the build will fail. 
 
-Read on to learn how to run, manage and create screenshot tests.
+For a plugin developer documentation have a look here: https://developer.piwik.org/guides/tests-ui
+The remaining part of this document is rather Piwik Core Developer related.
 
 ## Fixing a broken build 
 
@@ -42,62 +43,12 @@ To fix a broken build, follow these steps:
 
 _Note: the **development:sync-ui-test-screenshots** console command can be used to speed up the process. Run **./console help development:sync-ui-test-screenshots** to learn more._
 
-## <a name="setup"></a>Setup screenshots tests on your dev box
-
-These tests are in another repository but are included in Piwik as a submodule. To get the tests, run the following commands:
-
-    $ git submodule init
-    $ git submodule update
-
-In order to run UI tests, you need to have [phantomjs](http://phantomjs.org) version 1.9.0 or greater
-installed on your machine. You can download phantomjs [here](http://phantomjs.org/download.html). phantomjs is headless, so even if you're on a server without the X window system, you can still run the UI tests.
-
-To generate screenshots identical to those generated by Travis, we install some extra fonts. On Ubuntu run:
-
-    $ sudo apt-get install ttf-mscorefonts-installer imagemagick imagemagick-doc
-
-Imagick is used to generate the "difference" screenshots which show which pixels have changed.
-
-Removing this font may be useful if your generated screenshots' fonts do not match the expected screenshots:
-
-    $ sudo apt-get remove ttf-bitstream-vera
-
-### Configuring screenshot testing library
-
-The screenshot testing library's configuration resides in the `tests/UI/config.dist.js` file.
-If your development environment's PHP executable isn't named `php`
-or your dev Piwik install isn't at `http://localhost/` you may need to copy that file to 
-`tests/UI/config.js` and edit the contents of this file.
-
-For example if Piwik is setup at `http://localhost/piwik` modify the config.js such as:
-```
-exports.piwikUrl = "http://localhost/piwik/";
-exports.phpServer = {
-    HTTP_HOST: 'localhost',
-    REQUEST_URI: '/piwik/',
-    REMOTE_ADDR: '127.0.0.1'
-};
-
-```
-
 ## <a name="run-tests"></a>Running Tests
 
 You can test the UI by running the following command in the root piwik directory:
 
     $ ./console tests:run-ui
 
-This will run every UI test in Piwik Core as well as in each plugin directory.
-
-To run a single test, run:
-
-    $ ./console tests:run-ui TestName
-
-where **TestName** is the name of a mocha test specification. For example, to run the tests within the Dashboard\_spec.js, run:
-
-    $ ./console tests:run-ui Dashboard
-
-The test names to use is determined by the test itself in the calls to `describe(...`.
-
 The following options may be useful if you plan on running the UI tests locally often:
 
  * **--persist-fixture-data**: This will save the test data in a separate database so the setup only has to be run once.
@@ -105,136 +56,3 @@ The following options may be useful if you plan on running the UI tests locally
  * **--drop**: If you've used --persist-fixture-data and need to re-setup the separate data, use this option with --persist-fixture-data.
  * **--keep-symlinks**: If you want to visit the URLs of captured pages in a browser to diagnose failures use this option.
                         This will keep the recursive symlinks in tests/PHPUnit/proxy.
-
-## Writing Tests
-
-UI screenshot tests are run directly by phantomjs and are written using [mocha](http://visionmedia.github.io/mocha/) and [chai](http://chaijs.com).
-
-To create a new test, first decide whether it will belong to Piwik Core or a plugin. If it will belong to Piwik Core, the test should be placed within the `/tests/UI` directory. Otherwise, it should be placed within `tests/UI sub-directory of your plugin.
-
-All test files should have \_spec.js file name suffixes (for example, **ActionsDataTable\_spec.js**).
-
-Tests should be written using [BDD](http://en.wikipedia.org/wiki/Behavior-driven_development) style, for example:
-
-    describe("TheControlImTesting", function () {
-        // ...
-    });
-
-Since screenshots can take a while to capture, you will want to override mocha's default timeout like this:
-
-    describe("TheControlImTesting", function () {
-        this.timeout(0);
-
-        // ...
-    });
-
-Each test should use Piwik's special chai extension to capture and compare screenshots:
-
-    describe("TheControlImTesting", function () {
-        this.timeout(0);
-
-        var url = // ...
-
-        it("should load correctly", function (done) {
-            expect.screenshot("screenshot_name").to.be.capture(function (page) {
-                page.load(url);
-            }, done);
-        });
-    });
-
-If you want to compare a screenshot against an already existing expected screenshot you can do the following:
-
-    it("should load correctly", function (done) {
-        expect.screenshot("screenshot_to_comapre_against", "OptionalPrefix").to.be.capture("processed_screenshot_name", function (page) {
-            page.load(url);
-        }, done);
-    });
-
-If you want to compare only parts (all content within an element / selector) of a page you can do the following:
-
-    it("should load correctly", function (done) {
-        expect.screenshot("screenshot_name").to.be.captureSelector("#content", function (page) {
-            page.load(url);
-        }, done);
-    });
-
-If you want to compare a screenshot against an already existing expected screenshot and capture a selector you can do the following:
-
-    it("should load correctly", function (done) {
-        expect.screenshot("screenshot_name").to.be.captureSelector("processed_screenshot_name", "#content", function (page) {
-            page.load(url);
-        }, done);
-    });
-
-### <a name="manipulating-pages"></a>Manipulating Pages Before Capture
-
-The callback supplied to the `capture()` function accepts one argument: the page renderer. You can use this object to queue events to be sent to the page before taking a screenshot. For example:
-
-    .capture(function (page) {
-        page.click('.myDropDown');
-        page.mouseMove('.someOtherElement');
-    }, done);
-
-After each event the page renderer will wait for all AJAX requests to finish and for all images to load and then will wait 1s longer for any JavaScript to finish. If you want to wait longer, you can supply an extra wait time (in milliseconds) to the event queuing call:
-
-    .capture(function (page) {
-        page.click('.something');
-        page.click('.myReallyLongRunningJavaScriptFunctionButton', 10000); // will wait for 10s
-    }, done);
-
-_Note: phantomjs has its quirks and you may have to hack around to get certain behavior to work. For example, clicking a &lt;select&gt; will not open the dropdown, so dropdowns have to be manipulated via JavaScript within the page (ie, the .evaluate() method)._
-
-**Page Renderer Object Methods**
-
-The page renderer object has the following methods:
-
- * **click(selector, [modifiers], [waitTime])**: Sends a click to the element referenced by `selector`. Modifiers is an array of strings that can be used to specify keys that are pressed at the same time. Currently only `'shift'` is supported.
- * **mouseMove(selector, [waitTime])**: Sends a mouse move event to the element referenced by `selector`.
- * **mousedown(selector, [waitTime])**: Sends a mouse down event to the element referenced by `selector`.
- * **mouseup(selector, [waitTime])**: Sends a mouse up event to the element referenced by `selector`.
- * **sendKeys(selector, keyString, [waitTime])**: Clicks an element to bring it into focus and then simulates typing a string of keys.
- * **sendMouseEvent(type, pos. [waitTime])**: Sends a mouse event by name to a specific position. `type` is the name of an event that phantomjs will recognize. `pos` is a point, eg, `{x: 0, y: 0}`.
- * **dragDrop(selectorStart, selectorEnd, waitTime)**: Performs a drag/drop of an element (mousedown, mousemove, mouseup) from the element referenced by `selectorStart` and the element referenced by `selectorEnd`.
- * **wait([waitTime])**: Waits without doing anything.
- * **load(url, [waitTime])**: Loads a URL.
- * **reload([waitTime])**: Reloads the current URL.
- * **evaluate(impl, [waitTime])**: Evaluates a function (`impl`) within a webpage. `impl` is an actual function, not a string and must take no arguments.
-
-All **selector**s are jQuery selectors, so you can use jQuery only filters such as `:eq`.
-
-All events are real events, not synthetic DOM events.
-
-### Manipulating the Test Environment
-
-Sometimes it will be necessary to manipulate Piwik for testing purposes. You may want to remove randomness, manipulate data or simulate certain situations (such as there being no config.ini.php file). This section describes how you can do that.
-
-**In your screenshot tests,** use the global **testEnvironment** object. You can use this object to call Piwik API methods using the **callApi(method, params, callback)** method and to call Piwik Controller methods using the **callController(method, params, callback)** method.
-
-You can communicate with PHP code by setting data on the testEnvironment object and calling **save()**, for example:
-
-    testEnvironment.myTestVar = "abcdefg";
-    testEnvironment.save();
-
-This data will be loaded by the **TestingEnvironment** PHP class.
-
-**In your Piwik plugin,** handle the **TestingEnvironment.addHooks** event and use the data in the TestingEnvironment object. for example:
-
-    // event handler in a plugin descriptor class
-    public function addTestHooks($testingEnvironment) {
-        if ($testingEnvironment->myTestVar) {
-            // ...
-        }
-    }
-
-_Note: the Piwik environment is not initialized when the **TestingEnvironment.addHooks** event is fired, so attempts to use the Config and other objects may fail. It is best to use Piwik::addAction to inject logic._
-
-The following are examples of test environment manipulation:
-
- * [Overlay_spec.js](https://github.com/piwik/piwik/blob/master/tests/UI/specs/Overlay_spec.js)
- * [Dashboard_spec.js](https://github.com/piwik/piwik/blob/master/tests/UI/specs/Dashboard_spec.js)
- * [Login_spec.js](https://github.com/piwik/piwik/blob/master/tests/UI/specs/Login_spec.js)
-
-## Learn more
-
-Check out this blog post to learn more about Screenshot Tests in Piwik:
-[QA Screenshot Testing blog post](http://piwik.org/blog/2013/10/our-latest-improvement-to-qa-screenshot-testing/)