docs section about multi-browser testing, #29

doc/admin/installation.rst

@@ -288,6 +288,27 @@ For example, to add the test file ``example-spec.js``:
             'example-spec.js'
      ],
 
+Overriding Protractor's browser choices
+=======================================
+
+In ``protractor-conf.js``, add a ``multiCapabilities`` option in the following format:
+
+.. code:: javascript
+
+    multiCapabilities: [
+        {
+                browserName: '<browser name 1>'
+        },
+        {
+                browserName: '<browser name 2>'
+        },
+        ...
+    ]
+
+.. note::
+
+   You may need to download your browsers' WebDrivers separately - see `the official Selenium docs <https://seleniumhq.github.io/docs/wd.html#quick_reference>`_.
+
 Writing Protractor tests
 ========================
 

protractor-conf.js

@@ -7,6 +7,16 @@ exports.config = {
 	],
 	allScriptsTimeout: 60000,
 
+	// to override the default browser that Protractor uses:
+	// give a list of browsers to use (firefox, chrome, safari, etc.)
+	// e.g.:
+	//multiCapabilities: [{
+	//	browserName: 'firefox'
+	//},
+	//{
+	//	browserName: 'chrome'
+	//}],
+
 	// disable some selenium~browser notification than can steal focus
 	notify: false,