Cloudstack API documentation is woefully out of date

[ilsaloving-gander]

problem

I was having trouble getting the cloudstack terraform provider to work, and I ended up tracking the problem all the way back to the API. Are the API docs edited by hand? Because they are very out of date compared to the actual API code.

This has caused a cascading set of problems with everything depending on the API, including the Cloudstack terraform provider, and the Cloudstack go library that that provider depends on.

versions

4.21

The steps to reproduce the bug

n/a

What to do about it?

Where can we find up to date documentation?

[shwstppr]

@ilsaloving-gander it would help if you can elaborate and pin point your issue. CloudStack API documentation is auto generated based on annotations in the java code