document new attributes
document read accessors more places
Bump version
update changelog
Fix typo