added some notes on notes and entities