partly documented the entry controller