update README to reflect some convenience methods