Document RestResponse<T> in rest client

[maxandersen]

Description

I've multiple times has the need to do more "rest full" behaviors that needed access to response headers ( to get etag ) etc.

turns out that the rest client supports things like:

 @GET
        @Path("/public/schedules")
        RestResponse<ScheduleLinks> getSchedules();

but its not documented at all at https://quarkus.io/guides/rest-client

discussed a bit here https://quarkusio.zulipchat.com/#narrow/stream/187030-users/topic/Getting.20headers.20like.20etag.20via.20rest.20client.20.3F

opening this to have a trace of it and when someone (even me) have time to document it feel encouraged to do so :)

Implementation ideas

No response

[quarkus-bot]

You added a link to a Zulip discussion, please make sure the description of the issue is comprehensive and doesn't require accessing Zulip

_{This message is automatically generated by a bot.}

[quarkus-bot]

/cc @cescoffier (rest-client), @geoand (rest-client)

[geoand]

cc @lasteris

[lasteris]

I will do it

[geoand]

🙏🏽