[readme] flesh out content

README.md

@@ -1,2 +1,64 @@
-# call-bind
+# call-bind <sup>[![Version Badge][npm-version-svg]][package-url]</sup>
+
+[![github actions][actions-image]][actions-url]
+[![coverage][codecov-image]][codecov-url]
+[![dependency status][deps-svg]][deps-url]
+[![dev dependency status][dev-deps-svg]][dev-deps-url]
+[![License][license-image]][license-url]
+[![Downloads][downloads-image]][downloads-url]
+
+[![npm badge][npm-badge-png]][package-url]
+
 Robustly `.call.bind()` a function.
+
+## Getting started
+
+```sh
+npm install --save call-bind
+```
+
+## Usage/Examples
+
+```js
+const assert = require('assert');
+const callBind = require('call-bind');
+const callBound = require('call-bind/callBound');
+
+function f(a, b) {
+	assert.equal(this, 1);
+	assert.equal(a, 2);
+	assert.equal(b, 3);
+	assert.equal(arguments.length, 2);
+}
+
+const fBound = callBind(f);
+
+const slice = callBound('Array.prototype.slice');
+
+delete Function.prototype.call;
+delete Function.prototype.bind;
+
+fBound(1, 2, 3);
+
+assert.deepEqual(slice([1, 2, 3, 4], 1, -1), [2, 3]);
+```
+
+## Tests
+
+Clone the repo, `npm install`, and run `npm test`
+
+[package-url]: https://npmjs.org/package/call-bind
+[npm-version-svg]: https://versionbadg.es/ljharb/call-bind.svg
+[deps-svg]: https://david-dm.org/ljharb/call-bind.svg
+[deps-url]: https://david-dm.org/ljharb/call-bind
+[dev-deps-svg]: https://david-dm.org/ljharb/call-bind/dev-status.svg
+[dev-deps-url]: https://david-dm.org/ljharb/call-bind#info=devDependencies
+[npm-badge-png]: https://nodei.co/npm/call-bind.png?downloads=true&stars=true
+[license-image]: https://img.shields.io/npm/l/call-bind.svg
+[license-url]: LICENSE
+[downloads-image]: https://img.shields.io/npm/dm/call-bind.svg
+[downloads-url]: https://npm-stat.com/charts.html?package=call-bind
+[codecov-image]: https://codecov.io/gh/ljharb/call-bind/branch/main/graphs/badge.svg
+[codecov-url]: https://app.codecov.io/gh/ljharb/call-bind/
+[actions-image]: https://img.shields.io/endpoint?url=https://github-actions-badge-u3jn4tfpocch.runkit.sh/ljharb/call-bind
+[actions-url]: https://github.com/ljharb/call-bind/actions

package.json

@@ -22,6 +22,7 @@
 		"prepublish": "not-in-publish || npm run prepublishOnly",
 		"prepublishOnly": "safe-publish-latest",
 		"lint": "eslint --ext=.js,.mjs .",
+		"postlint": "evalmd README.md",
 		"pretest": "npm run lint",
 		"tests-only": "nyc tape 'test/*'",
 		"test": "npm run tests-only",
@@ -62,6 +63,7 @@
 		"aud": "^1.1.5",
 		"auto-changelog": "^2.3.0",
 		"eslint": "^7.32.0",
+		"evalmd": "^0.0.19",
 		"nyc": "^10.3.2",
 		"safe-publish-latest": "^1.1.5",
 		"tape": "^5.3.1"