Closes #257 - Improve README and break into multiple docs

Pull request for #257
fixed in 482c278