During a coding interview, the interviewer pointed out the confusion that get_courses has. Because, based on the name, it should probably return all the courses available within a subject. But instead, we give all the classes that are available for the term.
So I simply changed the function from get_courses to get_classes. With this, I maintained that get_courses will still work but now will throw a warning to the developer to switch over. I think in a future version of this API we should return the results of peoplesoft mobile's course catalog since it would better reflect what get_course should return.
During a coding interview, the interviewer pointed out the confusion that
get_courses
has. Because, based on the name, it should probably return all the courses available within a subject. But instead, we give all the classes that are available for the term.So I simply changed the function from
get_courses
toget_classes
. With this, I maintained thatget_courses
will still work but now will throw a warning to the developer to switch over. I think in a future version of this API we should return the results of peoplesoft mobile's course catalog since it would better reflect whatget_course
should return.