fixed non-indicative names, added documentation to controller