documentation updates and updates to read functions