Docs: Final edits, Style enhancements, Vale checks

[sheilamjones]

This PR fixes style issues (title capitalization, one sentence per line...), links, Vale issues, and some grammar as per the preferred Quarkus Contributor guidelines in the security-oidc-bearer-token-authentication.adoc (OpenID Connect (OIDC) Bearer token authentication guide)

[github-actions]

🙈 The PR is closed and the preview is expired.

[sberyozkin]

Hi Sheila, it all look nice, once one minor suggestion from me,

enjoy the holidays, thanks

[MichalMaler]

@sheilamjones
Hello! Comment I cant apply directly: Missing article
Line 1232:

Authentication that requires a dynamic tenant will fail.

Line 1238:

You can filter OIDC requests made by Quarkus to the OIDC provider by registering one or more `OidcRequestFiler` implementations, which can update or add new request headers and log requests.

[MichalMaler]

@sheilamjones Added some minimalism and grammar-fixing suggestions. Cheers!

[sheilamjones]

@sheilamjones Hello! Comment I cant apply directly: Missing article Line 1232:

Authentication that requires a dynamic tenant will fail.

Line 1238:

You can filter OIDC requests made by Quarkus to the OIDC provider by registering one or more `OidcRequestFiler` implementations, which can update or add new request headers and log requests.

Good catches. Fixed.

[sheilamjones]

Thanks so much @MichalMaler for your great review and suggestions. I implemented almost all, but have a couple of questions to clarify with Sergey.

[sberyozkin]

@sheilamjones This is another nearly perfect PR, it must have been hard given all the specifics and some mess I've created, thanks, a few suggestions are proposed, nothing major, thanks

[sberyozkin]

@sheilamjones Only 4 minor suggestions are open, nearly ready to go, thanks

[sheilamjones]

Hi @sberyozkin,
Thanks again for your time and additional reviews of this one. I have updated per your suggestions. With regards to the use of "recommends", we are not meant to use this in our Docs according to our guidelines. Instead, we are to make a direct statement. I did this for line 662. If this looks okay with you, this one is ready to merge.
Many thanks,
Sheila

[sheilamjones]

Hi @sberyozkin, Thanks again for your patience with this PR and for all your great reviews. I completed the additional couple of changes based on your feedback. This is now ready for your final signoff and merge.
Kind regards,
Sheila

[sberyozkin]

Thanks Sheila