update read/write structure with comments