added some explanation of entities