Finish and improve the documentation

[daviddias]

[victorb]

I'm currently redoing the readme a bit. You could assign me if you please.

[daviddias]

awesome! Thank you @victorbjelkholm

@jbenet is the one able to assign people on orgs/repos

[jbenet]

@victorbjelkholm ok you are part of the github node-ipfs team now. please do not merge things, or push straight to master (unless you maintain the project) please use a branch on the same repo and issue a PR and get the repo maintainer to review and then merge it

[jbenet]

Actually, i added you directly to this repo instead, as you need more access will bump it up

[jbenet]

@diasdavid you now have admin on all these repos so you should be able to add people.

[daviddias]

Thanks @jbenet :)

[daviddias]

Note on: #33 (comment) to be added to the docs

[RichardLitt]

@victorbjelkholm How's this going? Is there anything I can help with?

[victorb]

@RichardLitt Hey! Yes, of course. I've made the structure to be proper but have yet to fill out all the details with calls. Take a look in my branch (that currently have to be rebased from master but have yet to get time to do that) https://github.com/VictorBjelkholm/node-ipfs-api/tree/better-readme

Basically, the only thing I've done is added a ToC, changed the structure and made the wording a bit better.

[dignifiedquire]

Just a note, might make sense to have a separate api.md document with those details and just a link from the readme, to keep readme at a reasonable length.