updates to entities
added controller docs