adds some docs on determining new entities in events.