Files API spec

[hackergrrl]

As far as I've been able to discern, this only exists in the minds of @jbenet @diasdavid @whyrusleeping . Let's get this documented!

[RichardLitt]

This should also be added to the go-ipfs mans.

@noffle What are you proposing that isn't in ipfs-man at the moment?

[hackergrrl]

@RichardLitt: here's the current ipfs files --help output:

    ipfs files - Manipulate unixfs files.

    Files is an API for manipulating IPFS objects as if they were a unix filesystem.

This doesn't help me answer the question "what is the files api?". We need a document that explains what the Files API is -- its key ideas & abstractions, why it's useful, etc -- in addition to good man/usage documents.

[RichardLitt]

Agreed. Thank you.

[daviddias]

@whyrusleeping down to create this spec? :)