I find that some public methods with more than 2 parameters would be easier to use if they were defined with non-positional
parameters. One example is the get_photos method:

def get_photos(pids = nil, subj_id = nil,  aid = nil)

This is hard to remember, and forces the developer to use method calls like this:

# Obtain all the photos on one album
session.get_photos(nil, nil, aid)

when it could be:

session.get_photos(:aid => aid)