Merge branch 'master' into refactor

1 files changed, 70 insertions, 17 deletions

diff --git a/README.md b/README.md
index 9527ca5..7eb97f5 100644
--- a/README.md
+++ b/README.md
@@ -1,12 +1,12 @@
 <p align="center">
-  <img src="https://i.imgur.com/BqsX9NT.png" width="256" height="256" alt="mitt">
+  <img src="https://i.imgur.com/BqsX9NT.png" width="300" height="300" alt="mitt">
   <br>
-  <b>Mitt</b>: tiny 200b functional event emitter / pubsub.
-  <br>
-  <a href="https://www.npmjs.org/package/mitt"><img src="https://img.shields.io/npm/v/mitt.svg?style=flat" alt="npm"></a> <a href="https://travis-ci.org/developit/mitt"><img src="https://travis-ci.org/developit/mitt.svg?branch=master" alt="travis"></a>
+  <a href="https://www.npmjs.org/package/mitt"><img src="https://img.shields.io/npm/v/mitt.svg?style=flat" alt="npm"></a> <a href="https://travis-ci.org/developit/mitt"><img src="https://travis-ci.org/developit/mitt.svg?branch=master" alt="travis"></a> <a href="https://david-dm.org/developit/mitt"><img src="https://david-dm.org/developit/mitt/status.svg" alt="dependencies Status"></a>
 </p>
 
-## Why Mitt?
+# Mitt
+
+> Tiny 200b functional event emitter / pubsub.
 
 -   **Microscopic:** weighs less than 200 bytes gzipped
 -   **Useful:** a wildcard `"*"` event type listens to all events
@@ -14,21 +14,42 @@
 -   **Functional:** methods don't rely on `this`
 -   **Great Name:** somehow [mitt](https://npm.im/mitt) wasn't taken
 
-> Mitt was made for the browser, but works in any JavaScript runtime. It has no dependencies and supports IE9+.
+Mitt was made for the browser, but works in any JavaScript runtime. It has no dependencies and supports IE9+.
 
-## Examples & Demos
+## Table of Contents
+- [Install](#install)
+- [Usage](#usage)
+- [Examples & Demos](#examples--demos)
+- [API](#api)
+- [Contribute](#contribute)
+- [License](#license)
 
-<a href="http://codepen.io/developit/pen/rjMEwW?editors=0110">
-  <b>Preact + Mitt Codepen Demo</b>
-  <br>
-  <img src="https://i.imgur.com/CjBgOfJ.png" width="278" alt="preact + mitt preview">
-</a>
+## Install
 
-* * *
+This project uses [node](http://nodejs.org) and [npm](https://npmjs.com). Go check them out if you don't have them locally installed.
 
-## Usage
+```sh
+$ npm install --save mitt
+```
+
+Then with a module bundler like [rollup](http://rollupjs.org/) or [webpack](https://webpack.js.org/), use as you would anything else:
+
+```javascript
+// using ES6 modules
+import mitt from 'mitt'
 
-After installing via `npm install --save mitt`:
+// using CommonJS modules
+var mitt = require('mitt')
+```
+
+The [UMD](https://github.com/umdjs/umd) build is also available on [unpkg](https://unpkg.com):
+
+```html
+<script src="https://unpkg.com/mitt/dist/mitt.umd.js"></script>
+```
+You can find the library on `window.mitt`.
+
+## Usage
 
 ```js
 import mitt from 'mitt'
@@ -50,7 +71,13 @@ emitter.on('foo', onFoo)   // listen
 emitter.off('foo', onFoo)  // unlisten
 ```
 
-* * *
+## Examples & Demos
+
+<a href="http://codepen.io/developit/pen/rjMEwW?editors=0110">
+  <b>Preact + Mitt Codepen Demo</b>
+  <br>
+  <img src="https://i.imgur.com/CjBgOfJ.png" width="278" alt="preact + mitt preview">
+</a>
 
 ## API
 
@@ -58,7 +85,7 @@ emitter.off('foo', onFoo)  // unlisten
 
 Mitt: Tiny (~200b) functional event emitter / pubsub.
 
-Returns **Mitt** 
+Returns **Mitt**
 
 #### emit
 
@@ -93,3 +120,29 @@ Remove an event handler for the given type.
 -   `handler` **[Function](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/function)** Handler function to remove
 
 Returns **[Object](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object)** the `mitt` instance for chaining
+
+## Contribute
+First off, thanks for taking the time to contribute!
+Now, take a moment to be sure your contributions make sense to everyone else.
+
+### Reporting Issues
+Found a problem? Want a new feature? First of all see if your issue or idea has [already been reported](../../issues).
+If don't, just open a [new clear and descriptive issue](../../issues/new).
+
+### Submitting pull requests
+Pull requests are the greatest contributions, so be sure they are focused in scope, and do avoid unrelated commits.
+
+- Fork it!
+- Clone your fork: `git clone https://github.com/<your-username>/mitt`
+- Navigate to the newly cloned directory: `cd mitt`
+- Create a new branch for the new feature: `git checkout -b my-new-feature`
+- Install the tools necessary for development: `npm install`
+- Make your changes.
+- Commit your changes: `git commit -am 'Add some feature'`
+- Push to the branch: `git push origin my-new-feature`
+- Submit a pull request with full remarks documenting your changes.
+
+## License
+
+[MIT License](LICENSE.md) &copy; [Jason Miller](https://jasonformat.com/)
+