We had one customer recommend organizing it like Amazon does - http://docs.amazonwebservices.com/AWSEC2/latest/APIReference

One interesting issue is that we're trying to be as RESTful as possible. So we don't have things like 'Actions' or 'Methods' that need to be listed out with specific parameters. But we do need to explain the URL building pattern and what happens with a GET vs POST and stuff.

Any suggestions or recommendations?