Why is information such as how to use Extras not included in the API documentation?

Question

While I enjoy a challenge I think it would really help developers if the API documentation was a little more comprehensive. I have spent many hours working out how to do things by searching for people's posts e.g.: Extras is not explained in the API but I found a post on here giving details. If I had not found it I would have assumed that a get for images did not return any URLs.

SO basically we need someone at SmugMug to Awsome-ize the Docs :)

Answer 1

Whenever in doubt or during development, use the "Heavy" response :)

But yeah, I'd second that, a few get-started examples would have been nice... I realize it's a lot of approaches to using the API and ditto programming languages though, and I've seen far worse than what is already provided.

It basically works like any other API, you send a request (they are all listed in the API docs) and supply some parameters (some are required, others are optional) which shape the response you get... Then you play with that response to produce what you want.