Enhancements for the Authentication mechanisms documentation

[MichalMaler]

QDOCS-93: Authentication mechanisms revamping

• Fixing the names to match diataxes style
• Adding a missing ID
• Cleaning content and moving it to dedicated sections
• Adding tables for the complete overview
• Style/grammar fixes

Initial preview for tables movements:
https://github.com/quarkusio/quarkus/blob/a3d55ddf0f11b353d0835e76760de5fe9e2ef75a/docs/src/main/asciidoc/security-authentication-mechanisms-concept.adoc

Renaming/Redirecting PR for these changes:
quarkusio/quarkusio.github.io#1623

Signed-off-by: Michal Maléř mmaler@redhat.com

[MichalMaler]

@sberyozkin @jmartisk Hello Sergey and Jan! Here are some changes for the mentioned section. It is possible that we will need to move the revamped tables to a more specific sections, and I will provide a final review when this shifts will be done.

Xrefs are currently not tested yet. Will do it as a final step

Can I ask you for a review?

Thank You.

[github-actions]

🙈 The PR is closed and the preview is expired.

[sberyozkin]

@MichalMaler Thanks for going ahead with creating a new table, IMHO it would be useful, a left a few comments.
By the way, please tweak the mutual TLS link at the very top of the builtin mechanisms section. I'm not sure though we need those Basic/Form/MTLS links given that right below them Basic/Form/MTLS subsections start ? Michelle, @michelle-purcell would you like to retain them ?

[MichalMaler]

@MichalMaler Thanks for going ahead with creating a new table, IMHO it would be useful, a left a few comments. By the way, please tweak the mutual TLS link at the very top of the builtin mechanisms section. I'm not sure though we need those Basic/Form/MTLS links given that right below them Basic/Form/MTLS subsections start ? Michelle, @michelle-purcell would you like to retain them ?

@sberyozkin I fixed the link. Will remove them if @michelle-purcell agrees they are redundant or just residuals after the content movement :) Let me know.

[MichalMaler]

@sberyozkin I think we are ready to merge.
The xref:security-oidc-code-flow-authentication-concept.adoc[OIDC Web] link will be working when the Sheila's PR (#30518) is merged.

[sheilamjones]

Hi @MichalMaler, good job on the restructuring here. I just had a couple of minor comments and suggestions.
Kind regards,
Sheila

[MichalMaler]

Hi @MichalMaler, good job on the restructuring here. I just had a couple of minor comments and suggestions. Kind regards, Sheila

Thank you for quick and great review, as always :) Applied most of your suggestions. GJ! @sheilamjones

[MichalMaler]

GH Preview: https://github.com/quarkusio/quarkus/blob/a3d55ddf0f11b353d0835e76760de5fe9e2ef75a/docs/src/main/asciidoc/security-authentication-mechanisms-concept.adoc

[sberyozkin]

IMHO it is now nearly ready to go.

@sheilamjones Please update your PR when you get a chance as Michal's PR points to the file which will only be resolvable once your PR gets merged :-), so for now please don't merge

[MichalMaler]

Pushed the latest update:

[sberyozkin]

Hey @MichalMaler Sheila's PR is now on the main branch, can you please rebase and check the links, FYI, the OIDC web app concept doc has been renamed, so some minor sync will be needed for your PR, thanks

[MichalMaler]

@sberyozkin Hello Sergey! Thx for letting me know. One additional xref fixed. The whole PR now using the new names that reflects Sheila's work.
We did some good job here again. Cheers!

[MichalMaler]

This should be merged too, but it is not my call:
quarkusio/quarkusio.github.io#1623

[sberyozkin]

@MichalMaler Great work indeed, thanks very much

[gsmet]

I'm unmarking all the doc PRs for backports. They are all part of massive changes that shouldn't be backported. Please don't mark for backport massive structural changes to the doc.