Move testing out of docs

Fixes #564.

Author: pluma

README.md

@@ -47,11 +47,10 @@ const db = new Database();
 var arangojs = require("arangojs");
 var db = new arangojs.Database();
 var now = Date.now();
-db
-  .query({
-    query: "RETURN @value",
-    bindVars: { value: now }
-  })
+db.query({
+  query: "RETURN @value",
+  bindVars: { value: now }
+})
   .then(function(cursor) {
     return cursor.next().then(function(result) {
       // ...
@@ -66,6 +65,62 @@ db
 
 [Latest Documentation](https://docs.arangodb.com/devel/Drivers/JS/)
 
+## Testing
+
+Run the tests using the `yarn test` or `npm test` commands:
+
+```sh
+yarn test
+# - or -
+npm test
+```
+
+By default the tests will be run against a server listening on
+`http://localhost:8529` (using username `root` with no password). To
+override this, you can set the environment variable `TEST_ARANGODB_URL` to
+something different:
+
+```sh
+TEST_ARANGODB_URL=http://myserver.local:8530 yarn test
+# - or -
+TEST_ARANGODB_URL=http://myserver.local:8530 npm test
+```
+
+For development arangojs tracks the development build of ArangoDB. This means
+tests may reflect behavior that does not match any existing public release of
+ArangoDB.
+
+To run tests for a specific release of ArangoDB other than the latest
+development build, use the environment variable `ARANGO_VERSION`, e.g. for 3.3:
+
+```sh
+ARANGO_VERSION=30300 yarn test
+# - or -
+ARANGO_VERSION=30300 npm test
+```
+
+The value follows the same format as the `arangoVersion` config option,
+i.e. XYYZZ where X is the major version, YY is the two digit minor version
+and ZZ is the two digit patch version (both zero filled to two digits).
+
+Any incompatible tests will appear as skipped (not failed) in the test result.
+
+To run the resilience/failover tests you need to set the environment variables
+`RESILIENCE_ARANGO_BASEPATH` (to use a local build of ArangoDB) or
+`RESILIENCE_DOCKER_IMAGE` (to use a docker image by name):
+
+```sh
+RESILIENCE_ARANGO_BASEPATH=../arangodb yarn test
+# - or -
+RESILIENCE_ARANGO_BASEPATH=../arangodb npm test
+```
+
+This runs only the resilience/failover tests, without running any other tests.
+
+Note that these tests are generally a lot slower than the regular test suite
+because they involve shutting down and restarting individual ArangoDB server
+instances.
+
 ## License
 
 The Apache License, Version 2.0. For more information, see the accompanying

docs/Drivers/JS/GettingStarted/README.md

@@ -34,11 +34,11 @@ The version number of this driver does not indicate supported ArangoDB versions!
 
 This driver uses semantic versioning:
 
-* A change in the bugfix version (e.g. X.Y.0 -> X.Y.1) indicates internal
+- A change in the bugfix version (e.g. X.Y.0 -> X.Y.1) indicates internal
   changes and should always be safe to upgrade.
-* A change in the minor version (e.g. X.1.Z -> X.2.0) indicates additions and
+- A change in the minor version (e.g. X.1.Z -> X.2.0) indicates additions and
   backwards-compatible changes that should not affect your code.
-* A change in the major version (e.g. 1.Y.Z -> 2.0.0) indicates _breaking_
+- A change in the major version (e.g. 1.Y.Z -> 2.0.0) indicates _breaking_
   changes that require changes in your code to upgrade.
 
 If you are getting weird errors or functions seem to be missing, make sure you
@@ -58,27 +58,6 @@ You can find the documentation for each version by clicking on the corresponding
 date on the left in
 [the list of version tags](https://github.com/arangodb/arangojs/tags).
 
-## Testing
-
-Run the tests using the `yarn test` or `npm test` commands:
-
-```sh
-yarn test
-# - or -
-npm test
-```
-
-By default the tests will be run against a server listening on
-`http://localhost:8529` (using username `root` with no password). To
-override this, you can set the environment variable `TEST_ARANGODB_URL` to
-something different:
-
-```sh
-TEST_ARANGODB_URL=http://myserver.local:8530 yarn test
-# - or -
-TEST_ARANGODB_URL=http://myserver.local:8530 npm test
-```
-
 ## Install
 
 ### With Yarn or NPM
@@ -170,11 +149,10 @@ const db = new Database();
 var arangojs = require("arangojs");
 var db = new arangojs.Database();
 var now = Date.now();
-db
-  .query({
-    query: "RETURN @value",
-    bindVars: { value: now }
-  })
+db.query({
+  query: "RETURN @value",
+  bindVars: { value: now }
+})
   .then(function(cursor) {
     return cursor.next().then(function(result) {
       // ...
@@ -230,15 +208,14 @@ If the request failed at a network level or the connection was closed without re
 ```js
 // Using async/await
 try {
-  const info = await db.createDatabase('mydb');
+  const info = await db.createDatabase("mydb");
   // database created
 } catch (err) {
   console.error(err.stack);
 }
 
 // Using promises with arrow functions
-db.createDatabase('mydb')
-.then(
+db.createDatabase("mydb").then(
   info => {
     // database created
   },