Spage has uploaded a new change for review.

  https://gerrit.wikimedia.org/r/51069


Change subject: Improve README
......................................................................

Improve README

Change-Id: I64760e3ffb00ff3b3e880c33273e1e10e15584fb
---
M README.md
1 file changed, 13 insertions(+), 12 deletions(-)


  git pull ssh://gerrit.wikimedia.org:29418/qa/browsertests 
refs/changes/69/51069/1

diff --git a/README.md b/README.md
index f39f5ff..03c6977 100644
--- a/README.md
+++ b/README.md
@@ -2,30 +2,31 @@
 
 ## Environment
 
-File with credentials should be located at `/private/wmf/secret.yml`.
+To run the Selenium tests you will have to install Ruby (look at .rvmrc for 
the exact version), the latest versions of RubyGems, and Firefox (the default 
browser in which the tests run). The easiest way to install Ruby on Linux/Unix 
is RVM (https://rvm.io/) and on Windows RubyInstaller 
(http://rubyinstaller.org/).
 
-To run the Selenium tests you will have to install Ruby (for the exact version 
see .rvmrc), the latest versions of RubyGems and Firefox. The easiest way to 
install Ruby on *nix is RVM (https://rvm.io/) and on Windows RubyInstaller 
(http://rubyinstaller.org/).
-
-Update RubyGems and install required RubyGems:
+Update RubyGems and install the required RubyGems:
 
     gem update --system
     gem install bundler
     bundle install
 
-Run the tests with `bundle exec rake`.
+You will need a file with credentials located at `/private/wmf/secret.yml`. 
For local testing, create a user named "Selenium user" on your local wiki and 
record the password in this file as
 
-HTML report is created at reports/ and XML report (for Jenkins) is created at 
reports/junit.
+    mediawiki_password: password here
+
+Run the tests with `bundle exec rake`, this should start Firefox.
+The test run creates an HTML report in reports/ and an XML report (for 
Jenkins) in reports/junit.
+
+To run a single test enter `bundle exec cucumber 
features/FEATURE_NAME.feature`.
 
 ## Sites
 
-Code is pushed to 
https://gerrit.wikimedia.org/r/gitweb?p=qa/browsertests.git;a=summary
+The code repository is 
https://gerrit.wikimedia.org/r/gitweb?p=qa/browsertests.git , the GitHub mirror 
is at https://github.com/wikimedia/qa-browsertests
 
-GitHub mirror is at https://github.com/wikimedia/qa-browsertests
+Mobile tests are in the `tests/acceptance` folder of the 
[MobileFrontend](https://github.com/wikimedia/mediawiki-extensions-MobileFrontend)
 extension.
 
-Mobile tests are in `tests/acceptance` folder of 
[MobileFrontend](https://github.com/wikimedia/mediawiki-extensions-MobileFrontend)
 extension.
+The Jenkins instance that orchestrates the tests is hosted at 
https://wmf.ci.cloudbees.com/
 
-Jenkins is hosted at https://wmf.ci.cloudbees.com/
-
-Tests are running at http://saucelabs.com/
+The tests are run in multiple browsers at http://saucelabs.com/
 
 [![Code 
Climate](https://codeclimate.com/badge.png)](https://codeclimate.com/github/wikimedia/qa-browsertests)

-- 
To view, visit https://gerrit.wikimedia.org/r/51069
To unsubscribe, visit https://gerrit.wikimedia.org/r/settings

Gerrit-MessageType: newchange
Gerrit-Change-Id: I64760e3ffb00ff3b3e880c33273e1e10e15584fb
Gerrit-PatchSet: 1
Gerrit-Project: qa/browsertests
Gerrit-Branch: master
Gerrit-Owner: Spage <[email protected]>

_______________________________________________
MediaWiki-commits mailing list
[email protected]
https://lists.wikimedia.org/mailman/listinfo/mediawiki-commits

Reply via email to