fix the docblocks & add Entity::apply