apply doc related suggestions from code review
apply doc related suggestions from code review

Co-authored-by: Gwenneg Lepage <bdde56e77f8e9ab560e45d264ecb5e294fa50c28@users.noreply.github.com>
quarkusio/quarkus,quarkusio/quarkus,quarkusio/quarkus,quarkusio/quarkus,quarkusio/quarkus