fix(documentation): improve documentation

docs/configuration.md

@@ -0,0 +1,8 @@
+You can deploy test result to public sonarcloud.
+
+| Environment variable | Description                                 |
+|----------------------|---------------------------------------------|
+| `SONAR_TOKEN`        | token to be used                            |
+| `LCOV_INFO_PATH`     | the `lcov.info` path (`coverage/lcov.info`) |
+
+This is auto configured for you if you use rollup-umd.

docs/getting-started.md

@@ -0,0 +1,31 @@
+$PACKAGE_NAME contain the job test stage for all rollup-umd project.
+
+You can run the build stage by doing:
+
+```bash
+npx $PACKAGE_NAME
+```
+
+It should be installed as a `devDependencies` so we can follow the version used by the rollup-umd project.
+
+To use it, just use the script within your `.travis.yml`:
+
+
+```yml
+# Job: Test
+- stage: test
+  node_js:
+    - 'lts/*'
+    - '10'
+    - '8'
+  addons:
+    sonarcloud:
+      organization: $(echo $TRAVIS_REPO_SLUG | awk -F '/' '{print $1}')
+  script:
+    - npx $PACKAGE_NAME
+```
+
+Note: 
+
+`organization` is necessary to use the travis sonarcloud driver.
+Using `$(echo $TRAVIS_REPO_SLUG | awk -F '/' '{print $1}')` we set it to the github namespace of the project. 

package.json

@@ -331,4 +331,4 @@
   },
   "declinationId": "cli",
   "contributors": []
-}
+}

src/cli/cmds/test.js

@@ -8,4 +8,11 @@ export const builder = (yargs) => yargs
   });
 export const command = ['*', 'test'];
 export const desc = 'Run test jobs';
-export const handler = (argv) => test(argv);
+export const handler = (argv) => () => {
+  test(argv, (err, code) => {
+    if (code !== 0) {
+      console.log(`ps process exited with code ${code}`);
+      process.exitCode = code;
+    }
+  });
+};

styleguide/styleguide.ext.json

@@ -14,6 +14,14 @@
       "name": "Installation",
       "content": "docs/installation.md"
     },
+    {
+      "name": "Getting started",
+      "content": "docs/getting-started.md"
+    },
+    {
+      "name": "Configuration",
+      "content": "docs/configuration.md"
+    },
     {
       "name": "JSdoc",
       "description": "This part is generated from the JSdoc annotations in the source code.",
@@ -50,4 +58,4 @@
     "url": "https://github.com/rollup-umd/test",
     "text": "Fork us on GitHub"
   }
-}
+}