Added acceptance tests documentation

1 files changed, 31 insertions, 0 deletions

diff --git a/doc/tests.markdown b/doc/tests.markdown
index b2d95491..5e3d71d2 100644
--- a/doc/tests.markdown
+++ b/doc/tests.markdown
@@ -12,6 +12,8 @@ Requirements
 - PHP cli
 - PHPUnit installed
 - Mysql and Postgresql (optional)
+- Selenium (optional)
+- Firefox (optional)
 
 Unit Tests
 ----------
@@ -83,6 +85,11 @@ From your Kanboard directory, run the command `phpunit -c tests/units.postgres.x
 Integration Tests
 -----------------
 
+Acceptance tests (also known as end-to-end tests and sometimes functional tests) allow us to test the actual functionality of the browser using Selenium and PHPUnit.
+
+The PHPUnit config file is `tests/acceptance.xml`.
+From your Kanboard directory, run the command `phpunit -c tests/units.sqlite.xml`.
+
 Actually only the API calls are tested.
 
 Real HTTP calls are made with those tests.
@@ -116,6 +123,30 @@ Time: 1.18 minutes, Memory: 14.75Mb
 OK (135 tests, 526 assertions)
 ```
 
+Acceptance Tests
+-----------------
+
+Acceptance tests (also sometimes known as end-to-end tests, and functional tests) test the actual functionality of the UI in a browser using Selenium.
+
+In order to run these tests you must have [Selenium Standalone Server](http://www.seleniumhq.org/download/) installed, and a compatible version of Firefox.
+
+The PHPUnit config file is `tests/acceptance.xml`.
+With Selenium and the Kanboard app running, from your Kanboard directory, run the command `make test-browser`. This will initiate the testing suite and you will see Firefox open automatically and perform the actions specified in the acceptance tests.  
+
+Example:
+
+```bash
+$ make test-browser
+PHPUnit 4.8.26 by Sebastian Bergmann and contributors.
+
+..
+
+Time: 5.59 seconds, Memory: 5.25MB
+
+OK (2 tests, 5 assertions)
+```
+
+
 Continuous Integration with Travis-CI
 -------------------------------------