Updated README

Author: Axel Rindle

README.md

@@ -7,16 +7,16 @@ npm install --save github-version-checker
 ```
 
 ## Usage
-### JavaScript
 ```javascript
 // require modules
 const versionCheck = require('github-version-checker');
 const pkg = require('./package.json'); // or whereever your package.json lies
 
-// version check options
+// version check options (for details see below)
 const options = {
   repo: 'axelrindle/github-version-checker', // will be expanded to https://api.github.com/repos/axelrindle/github-version-checker/releases
-  currentVersion: pkg.version
+  currentVersion: pkg.version, // your app's current version
+  includePreReleases: false // if you want to check pre-releases to
 };
 versionCheck(options, function (update) { // callback function
   if (update) { // print some update info if an update is available
@@ -30,28 +30,17 @@ versionCheck(options, function (update) { // callback function
   //...
 });
 ```
+Check the [examples folder](https://github.com/axelrindle/github-version-checker/tree/master/examples) for more examples.
 
-### CoffeeScript
-```coffeescript
-# require modules
-versionCheck = require('github-version-checker')
-pkg = require('./package.json') # or whereever your package.json lies
+### Note on semantic versioning
+Always try to follow a clear [semver format](http://semver.org/). This helps to avoid parsing mistakes and getting a clear result.
 
-# version check options
-options =
-  repo: 'axelrindle/github-version-checker'
-  currentVersion: pkg.version
-
-versionCheck options, (update) -> # callback function
-  if update # print some update info if an update is available
-    console.log 'An update is available!'
-    console.log 'New version: ' + update.tag_name
-    console.log 'Details here: ' + update.html_url
-
-  # start your app
-  console.log 'Starting app...'
-  #...
-```
+## Options
+Option | Default value | Description
+--- | --- | ---
+repo | **None. Required option** | Defines from which GitHub repository to load releases from.
+currentVersion | **None. Required option** | Your app's current version. Needed to check if a newer release is found.
+includePreReleases | false | Whether or not to include pre-releases. **Note:** This will fetch **all** releases, which might result in high traffic, depending on how much releases your app has on GitHub.
 
 ## The `update` object
 The object you receive in the callback function, follows the format specified here:
@@ -61,4 +50,4 @@ https://developer.github.com/v3/repos/releases/#get-a-single-release
 
 * Add a sync method returning just `true` or `false`
 * Add settings to define an own update service
-* Only compare to the latest release on GitHub (see [#1](https://github.com/axelrindle/github-version-checker/issues/1))
+* ~~Only compare to the latest release on GitHub (see [#1](https://github.com/axelrindle/github-version-checker/issues/1))~~