Add result.error to docs
Re-organize README a bit, closes #1