Update readme

Add explanations of items that haven't been described.
create section for list of instance methods.