Add some notes about the changes to the write() implementation