Thank you for the initiative timcliff. I isited that site but it just didn't give me the answer immediately .
The question I wanfed answered was - how do I get my list of posts in descending order (from latest to oldest). The closest I got near was the API getDiscussionsByBlog() however I think there was something I wasn't able to get (filter by tags? I can't remember now) which made me resort to a other API.
So, for me, yes I agree it wpuld be very helpful if there was documentation on what parameters did an API accept particularly the query parameter.
And another are examples - code snippets I can use in my codes. I think it was 2 months ago I last checked and I haven't returned to the site after.