improve controller documentation