Standardize README

RichardLitt · RichardLitt · commit 9e3e0a3239f7 · 2016-06-22T11:00:33.000+01:00
See ipfs/community#124
diff --git a/README.md b/README.md
@@ -1,21 +1,30 @@
-Apiary IPFS HTTP API description
-================================
-
-> Apiary IPFS HTTP API description
+# Apiary IPFS HTTP API description
 
 [![](https://img.shields.io/badge/made%20by-Protocol%20Labs-blue.svg?style=flat-square)](http://ipn.io)
 [![](https://img.shields.io/badge/project-IPFS-blue.svg?style=flat-square)](http://ipfs.io/)
 [![](https://img.shields.io/badge/freenode-%23ipfs-blue.svg?style=flat-square)](http://webchat.freenode.net/?channels=%23ipfs)
+[![standard-readme compliant](https://img.shields.io/badge/standard--readme-OK-green.svg?style=flat-square)](https://github.com/RichardLitt/standard-readme)
+
+> Apiary IPFS HTTP API description
 
 [Live API](http://docs.ipfs.apiary.io/#)
 
-# API spec
+This is the IPFS HTTP API spec, currently based on using the [go-ipfs](https://github.com/ipfs/go-ipfs) implementation. You can find the official API spec at [the specs repo](https://github.com/ipfs/specs/tree/master/public-api).
 
-You can find the official API spec at the specs repo on:
+## Usage
 
-- https://github.com/ipfs/specs/tree/master/public-api
+Go look at the [Live API](http://docs.ipfs.apiary.io/#), or check out the [apiary.apib](apiary.apib) source in this repository. If you would like to run the `curl` commands, please have an `ipfs daemon` running. For more on that, go to [go-ipfs](https://github.com/ipfs/go-ipfs).
 
-# Want to hack on IPFS?
+## Contribute
+
+Feel free to join in. All welcome. Open an [issue](https://github.com/ipfs/http-api-spec/issues)!
+
+This repository falls under the IPFS [Code of Conduct](https://github.com/ipfs/community/blob/master/code-of-conduct.md).
+
+### Want to hack on IPFS?
 
 [![](https://cdn.rawgit.com/jbenet/contribute-ipfs-gif/master/img/contribute.gif)](https://github.com/ipfs/community/blob/master/contributing.md)
 
+## License
+
+MIT
