might be a swagger/openapi issue. golang for example does generated doc quite well imo. i wish other languages had the same.