Add documentation

Added new sections to README.md and moved the description of the
design and the tutorial to separate files under docs/