From 776333ff861bd4c4067ae76673b2c45d3b0d3184 Mon Sep 17 00:00:00 2001
From: Maik Riechert <maik.riechert@arcor.de>
Date: Wed, 23 Mar 2016 11:29:09 +0100
Subject: [PATCH] more readme

---
 README.md | 22 +++++++++++++++++-----
 1 file changed, 17 insertions(+), 5 deletions(-)

diff --git a/README.md b/README.md
index 8c402dd..bac3da1 100644
--- a/README.md
+++ b/README.md
@@ -1,19 +1,28 @@
-# Coverage REST Client
+# coverage-rest-client
 
 An experimental library that wraps [Coverage or Coverage Collection objects](https://github.com/Reading-eScience-Centre/coverage-jsapi)
 and runs operations like subsetting through a REST API that follows the ["Coverage Data REST API Core Specification"](https://github.com/Reading-eScience-Centre/coverage-restapi) instead of loading the complete data and doing it locally.
 
-## Example using covjson-reader
+## Usage
 
-We use the [covjson-reader](https://github.com/Reading-eScience-Centre/covjson-reader) library
-to load a [CoverageJSON](https://github.com/neothemachine/coveragejson) document which then is wrapped with the coverage-rest-client library in order to support pagination and run operations like subsetting or collection filtering server-side.
+coverage-rest-client can be used in browsers only.
 
-```js
+Standalone minified and source versions can be found in the [releases section](https://github.com/Reading-eScience-Centre/coverage-rest-client/releases). The library can also be used within npm, currently as a GitHub dependency only due to its experimental character.
+
+As an example, we use the [covjson-reader](https://github.com/Reading-eScience-Centre/covjson-reader) library
+to load a [CoverageJSON](https://github.com/neothemachine/coveragejson) document which then is wrapped with the coverage-rest-client library in order to support pagination and run operations like subsetting or collection filtering server-side:
+```html
+<script src="https://cdn.jsdelivr.net/covjson-reader/0.7/covjson-reader.min.js"></script>
+<script src="coverage-rest-client.min.js"></script>
+<script>
 var url = 'http://example.com/temperature.covjson'
 CovJSON.read(url).then(function (cov) {
   return CoverageREST.wrap(cov, {loader: CovJSON.read})
 }).then(function (cov) {
   // work with REST-enabled coverage data object
+}).catch(function (e) {
+  // there was an error when loading the coverage data
+  console.log(e)
 })
 ```
 
@@ -25,3 +34,6 @@ For the interested ones: All HTTP Link headers (which may be used for pagination
 
 Note that this library currently supports arbitrary JSON-LD and uses the [jsonld.js](https://github.com/digitalbazaar/jsonld.js) parser which is not that lightweight in terms of file size. It may be the case that in the future a JSON-LD profile for such coverage-related REST API control data is created which would force a specific JSON-LD structure and allow easier processing without a full JSON-LD parser.
 
+## Acknowledgments
+
+This library is developed within the [MELODIES project](http://www.melodiesproject.eu).