We are trying to use the OpenAPI specification you provide to generate Go and Python SDKs, but we are encountering various problems.
The first one is that a lot of definitions are incomplete and simply contain this message: “NOTE: This definition is not complete. We will be adding more detail in future releases of Octopus.” An example of that would be the " Channels" resource.
Another problem we are facing, is that when there are definitions they are incorrect. As an example I chose the “Lifecycles” resource, which expected a “Unit” as integer:
RetentionPeriod{
Unit integer($int32)
readOnly: true
Enum:
[ Days, Items ]
But in reality what is retrieved is a string:
“ReleaseRetentionPolicy”: {
“Unit”: “Days”,
“QuantityToKeep”: 15,
“ShouldKeepForever”: false
},
“TentacleRetentionPolicy”: {
“Unit”: “Items”,
“QuantityToKeep”: 5,
“ShouldKeepForever”: false
},
As a result, we cannot perform any schema validation.
Is there any plan to update this document to make is useful?
Thanks a lot in advance for your help.