General comment, do we need comments for the various methods in the apis in general? These seem fairly simple but seems like a good idea in general?