I think this will be a good approach to writing the documentation; In addition to explaining each class method, it would be helpful to have another page that describes the data that someone might be trying to get for whatever purpose, then we can say which functions would be useful for those scenarios and how to use them.