updated javadocs for new methods in controllers