readme

README.md

@@ -1,2 +1,49 @@
-# is-map
+# is-map <sup>[![Version Badge][2]][1]</sup>
+
+[![Build Status][3]][4]
+[![dependency status][5]][6]
+[![dev dependency status][7]][8]
+[![License][license-image]][license-url]
+[![Downloads][downloads-image]][downloads-url]
+
+[![npm badge][11]][1]
+
 Is this value a JS Map? This module works cross-realm/iframe, and despite ES6 @@toStringTag.
+
+## Example
+
+```js
+var isMap = require('is-map');
+assert(!isMap(function () {}));
+assert(!isMap(null));
+assert(!isMap(function* () { yield 42; return Infinity; });
+assert(!isMap(Symbol('foo')));
+assert(!isMap(1n));
+assert(!isMap(Object(1n)));
+
+assert(!isMap(new Set()));
+assert(!isMap(new WeakSet()));
+assert(!isMap(new WeakMap()));
+
+assert(isMap(new Map()));
+
+class MyMap extends Map {}
+assert(isMap(new MyMap()));
+```
+
+## Tests
+Simply clone the repo, `npm install`, and run `npm test`
+
+[1]: https://npmjs.org/package/is-map
+[2]: http://versionbadg.es/inspect-js/is-map.svg
+[3]: https://travis-ci.org/inspect-js/is-map.svg
+[4]: https://travis-ci.org/inspect-js/is-map
+[5]: https://david-dm.org/inspect-js/is-map.svg
+[6]: https://david-dm.org/inspect-js/is-map
+[7]: https://david-dm.org/inspect-js/is-map/dev-status.svg
+[8]: https://david-dm.org/inspect-js/is-map#info=devDependencies
+[11]: https://nodei.co/npm/is-map.png?downloads=true&stars=true
+[license-image]: http://img.shields.io/npm/l/is-map.svg
+[license-url]: LICENSE
+[downloads-image]: http://img.shields.io/npm/dm/is-map.svg
+[downloads-url]: http://npm-stat.com/charts.html?package=is-map