updated readability in controller defining method explicit inputs