add docs

[josmas]

docs to readme to:

• what is this library for
• install
• basic instantiation
• basic usage

dev docs to readme to:

• forking/cloning for local development
• contribution rules (copy from PaperBadger)
• testing guidelines
• architecture and main design decisions