quarkus-rest我正在使用Jakarta REST（以前称为 JAX-RS）的实现来开发 REST API 。我还使用quarkus-smallrye-openapi扩展来生成我的 API 规范（OpenAPI v3）。
我如何填写字段：使用注释或其他方式（无需手动编写规范）的路径项对象的摘要和描述？
我有一个按照2021 年 10 月的规范描述的 GraphQL API 。
size我有一个想要删除的论点。
type Product {
picture(size: Int): Url
}
但是如果不在 API 规范中通知消费者，我就不能立即将其删除。我知道工作草案规范允许使用带参数的 @deprecated 指令，但2021 规范不允许这样做。
如何在不违反 2021 规范的情况下以明智的方式删除该字段？
我曾有一个想法，即弃用该字段并在其旁边创建一个具有相同名称但没有参数的字段，但不幸的是这不是一个有效的操作。