Provide default values and additional constraints (e.g., max allowed value) in docs

[henryharbeck]

For example, it would be good to know the default values for limit, offset and order_by for the GetUserListRequest here without having to consult the source code instead. It is documented for the JS library.

[tmilewski]

Hi @henryharbeck! I've inquired about the missing values in the documentation.

The JS library is done by "hand" whereas many of our other SDKs (and the accompanying) documentation are generated from our OpenAPI Specs, which does have the values you've called out.

Thank you for surfacing this and we'll make sure to get it fixed.

[henryharbeck]

Thanks for the quick response and the pointer to the specs. Given #166 is closed in favour of this, I'd kindly ask for additional constraints (e.g., max allowed value) to also be documented. So in the case of limit, both the max of 500 and the default of 10.

Thanks again