Add DRF OpenAPI body parameters description
When creating a distribution one of the required body parameters is the publisher, as per DRF OpenAPI documentation.
/api/v3/distributions/ publisher string Required Publications created by this publisher are automaticallyserved as defined by this distribution
This parameter can not be any string, it has to be _href of the publisher, adding this to the description will improve the documentation. This is just one example, there are other similar cases.
#2 Updated by email@example.com over 2 years ago
I think this task can be closed now: https://docs.pulpproject.org/en/3.0/nightly/restapi.html#operation/distributions_create
#3 Updated by firstname.lastname@example.org over 2 years ago
- Status changed from NEW to CLOSED - CURRENTRELEASE
Closing now. As @dkliban mentioned, this is much better covered by the published swagger docs. Specifically, the publisher is not required, and the types are better represented for the fields.
string <uri> (Publisher) Nullable
Please register to edit this issue