OAS 3.1 retrofit

Current state (2026/02/05):

Thanks to Antoine's work we handle application routers, server resources (methods, operation annotations, payloads)

V1 Scope

It's time to precise the scope of a first version. Possible topics:

• authentication (scan the filters)
• extract server's host name(s) and port from component -> set as option
• document query parameters and headers: via Swagger annotations
• add partial support of Swagger annotations: summary and description properties seem to be a must-have
• add the ability to limit the number of variants or add them all in documentation (Jackson supports a bunch of variants whereas JSON seems the most important)

Other Topics

• Full support of Swagger annotations (lot of work)
• Partial support of Swagger annotations (list them)
• What about conflicts (annotations versus Restlet code)?
• How to check the documentation (via code generation for instance)?