fix notes on file layout