further documentation

1 files changed, 44 insertions, 3 deletions

diff --git a/tests/acceptance/readme.md b/tests/acceptance/readme.md
index 7fcc791da01..625036a9e4a 100644
--- a/tests/acceptance/readme.md
+++ b/tests/acceptance/readme.md
@@ -16,7 +16,7 @@ Install the webdriver
 ./node_modules/protractor/bin/webdriver-manager update
 ```
 
-Install as global commands ( optional )
+Install protractor as global command ( optional )
 ```
 npm install -g protractor
 ```
@@ -25,15 +25,56 @@ Run
 ---
 
 Run the tests with protractor
-
 ```
 protractor protractor.conf.js
 ```
 
 Run only a specific test suite or spec
-
 ```
 protractor protractor.conf.js --suite install
 protractor protractor_conf.js --params.baseUrl="http://127.0.0.1/ownClouds/test-community-7.0.1/" --suite=login
 protractor protractor_conf.js --params.baseUrl="http://127.0.0.1/ownClouds/test-community-7.0.1/" --specs tests/login/newUser_spec.js
 ```
+
+More Test Suits
+---------------
+
+You can find and define suites in ```protractor_conf.js```
+
+Install suite: Run this suite on a not yet installed ownCloud, it will install during the tests
+
+After installation tests should run without the "First Run Wizard" app because of timing issues.
+Disable the app on the server with 
+
+```
+php occ app:disable firstrunwizard
+```
+
+Page Objects
+------------
+
+The ```tests/pages``` folder contains page objects.
+A page object describes a webpage, gathers selectors and provides functions for actions on the page. 
+
+In the specs these higher level functionality can be reused and the tests become nice and readable.
+
+Development
+-----------
+
+A good starting point is the login suite in the login folder and the login page object.
+
+If you want to start only a single test (it) or collection of tests (describe) use:
+
+* iit to run a single test
+* ddescribe to run only this collection
+
+You can also use
+
+* xit to exclude this test
+* xdescribe to exclude this collection
+
+For deeper insights and api docs have a look at 
+
+* Protractor, [https://github.com/angular/protractor](https://github.com/angular/protractor)
+* Jasmine, [https://github.com/pivotal/jasmine](https://github.com/pivotal/jasmine)
+