Sync documentation of main branch

Author: actions-user

_data/versioned/main/index/quarkus.yaml

@@ -5,7 +5,7 @@ types:
   - title: Authorization of web endpoints
     filename: security-authorize-web-endpoints-reference.adoc
     summary: Quarkus has an integrated pluggable web security layer.
-    categories: "security, web"
+    categories: "web, security"
     id: security-authorize-web-endpoints-reference
     type: reference
     url: /guides/security-authorize-web-endpoints-reference
@@ -78,7 +78,7 @@ types:
     url: /guides/security-oidc-configuration-properties-reference
   - title: Quarkus style and content guidelines
     filename: doc-reference.adoc
-    summary: Guidelines are provided to help you to contribute clear and consistent content that is also sourced in the required structure and composition of Quarkus documentation.
+    summary: Guidelines are provided to help you to contribute clear and consistent content that is also sourced in the required diataxis structure and composition of Quarkus documentation.
     categories: contributing
     id: doc-reference
     type: reference
@@ -131,14 +131,14 @@ types:
   - title: Authentication mechanisms in Quarkus
     filename: security-authentication-mechanisms-concept.adoc
     summary: "The Quarkus Security framework supports multiple authentication mechanisms, which you can use to secure your applications."
-    categories: "security, web"
+    categories: "web, security"
     id: security-authentication-mechanisms-concept
     type: concepts
     url: /guides/security-authentication-mechanisms-concept
   - title: Basic authentication
     filename: security-basic-authentication-concept.adoc
     summary: HTTP Basic authentication is one of the least resource-demanding techniques that enforce access controls to web resources.
-    categories: "security, web"
+    categories: "web, security"
     id: security-basic-authentication-concept
     type: concepts
     url: /guides/security-basic-authentication-concept
@@ -152,21 +152,21 @@ types:
   - title: OpenID Connect (OIDC) Bearer authentication
     filename: security-oidc-bearer-token-authentication-concept.adoc
     summary: Secure HTTP access to Jakarta REST (formerly known as JAX-RS) endpoints in your application with Bearer authentication by using the Quarkus OpenID Connect (OIDC) extension.
-    categories: "security, web"
+    categories: "web, security"
     id: security-oidc-bearer-token-authentication-concept
     type: concepts
     url: /guides/security-oidc-bearer-token-authentication-concept
   - title: OpenID Connect authorization code flow mechanism for protecting web applications
     filename: security-oidc-code-flow-authentication-concept.adoc
-    summary: "To protect your web applications, you can use the authorization code flow mechanism provided by the Quarkus OpenID Connect (OIDC) extension."
-    categories: "security, web"
+    summary: "To protect your web applications, you can use the industry-standard authorization code flow mechanism provided by the Quarkus OpenID Connect (OIDC) extension."
+    categories: "web, security"
     id: security-oidc-code-flow-authentication-concept
     type: concepts
     url: /guides/security-oidc-code-flow-authentication-concept
   - title: Proactive authentication
     filename: security-proactive-authentication-concept.adoc
     summary: Proactive authentication is enabled in Quarkus by default.
-    categories: "security, web"
+    categories: "web, security"
     id: security-proactive-authentication-concept
     type: concepts
     url: /guides/security-proactive-authentication-concept
@@ -201,7 +201,7 @@ types:
   - title: Security vulnerability detection and reporting in Quarkus
     filename: security-vulnerability-detection-concept.adoc
     summary: Most of the Quarkus tags are registered in the US National Vulnerability Database (NVD) in Common Platform Enumeration (CPE) name format.
-    categories: "security, contributing"
+    categories: "contributing, security"
     id: security-vulnerability-detection-concept
     type: concepts
     url: /guides/security-vulnerability-detection-concept
@@ -214,7 +214,7 @@ types:
   howto:
   - title: Contribute to Quarkus documentation
     filename: doc-contribute-docs-howto.adoc
-    summary: "Contribute to the documentation by using the recommended steps, workflow, and style guidance to ensure the content successfully renders on the Quarkus website portal."
+    summary: "Contribute to the documentation by using the recommended diataxis content types, steps, workflow, and style guidance to ensure the content successfully renders on the Quarkus website portal."
     categories: contributing
     id: doc-contribute-howto
     type: howto
@@ -243,7 +243,7 @@ types:
   - title: Configure data sources in Quarkus
     filename: datasource.adoc
     summary: Use a unified configuration model to define datasources for Java Database Connectivity (JDBC) and Reactive drivers.
-    categories: "getting-started, reactive, data"
+    categories: "getting-started, data"
     id: datasources
     type: tutorial
     url: /guides/datasource
@@ -276,7 +276,7 @@ types:
   - title: Protect a web application by using OpenID Connect (OIDC) authorization code flow
     filename: security-oidc-code-flow-authentication-tutorial.adoc
     summary: "With the Quarkus OpenID Connect (OIDC) extension, you can protect application HTTP endpoints by using the OIDC Authorization Code Flow mechanism."
-    categories: "security, web"
+    categories: "web, security"
     id: security-oidc-code-flow-authentication-tutorial
     type: tutorial
     url: /guides/security-oidc-code-flow-authentication-tutorial
@@ -289,7 +289,7 @@ types:
   - title: Secure a Quarkus application with Basic authentication and Jakarta Persistence
     filename: security-basic-authentication-tutorial.adoc
     summary: Secure your Quarkus application endpoints by combining the built-in Quarkus Basic authentication with the Jakarta Persistence identity provider to enable role-based access control (RBAC).
-    categories: "security, getting-started"
+    categories: "getting-started, security"
     id: security-basic-authentication-tutorial
     type: tutorial
     url: /guides/security-basic-authentication-tutorial
@@ -961,7 +961,7 @@ types:
   - title: Simplified Hibernate ORM with Panache and Kotlin
     filename: hibernate-orm-panache-kotlin.adoc
     summary: This explains the specifics of using Hibernate ORM with Panache in a Kotlin project.
-    categories: "alt-languages, data"
+    categories: "data, alt-languages"
     type: guide
     url: /guides/hibernate-orm-panache-kotlin
   - title: Simplified Hibernate Reactive with Panache
@@ -979,13 +979,13 @@ types:
   - title: Simplified MongoDB with Panache and Kotlin
     filename: mongodb-panache-kotlin.adoc
     summary: This guide covers the usage of MongoDB using active records and repositories in a Kotlin project.
-    categories: "alt-languages, data"
+    categories: "data, alt-languages"
     type: guide
     url: /guides/mongodb-panache-kotlin
   - title: SmallRye Fault Tolerance
     filename: smallrye-fault-tolerance.adoc
     summary: This guide demonstrates how your Quarkus application can utilize the SmallRye Fault Tolerance specification through the SmallRye Fault Tolerance extension.
-    categories: "observability, web"
+    categories: "web, observability"
     type: guide
     url: /guides/smallrye-fault-tolerance
   - title: SmallRye GraphQL
@@ -1158,7 +1158,7 @@ types:
   - title: Using SSL With Native Executables
     filename: native-and-ssl.adoc
     summary: "In this guide, we will discuss how you can get your native images to support SSL, as native images don't support it out of the box."
-    categories: "security, core, native"
+    categories: "core, security, native"
     type: guide
     url: /guides/native-and-ssl
   - title: Using Security with .properties File
@@ -1265,7 +1265,7 @@ types:
   - title: Validation with Hibernate Validator
     filename: validation.adoc
     summary: This guide covers how to use Hibernate Validator/Bean Validation in your REST services.
-    categories: "data, web"
+    categories: "web, data"
     type: guide
     url: /guides/validation
   - title: Writing JSON REST Services
@@ -1334,8 +1334,6 @@ categories:
   cat-id: native
 - category: Observability
   cat-id: observability
-- category: Reactive
-  cat-id: reactive
 - category: Security
   cat-id: security
 - category: Serialization

_versions/main/guides/config-reference.adoc

@@ -265,7 +265,7 @@ APIs are not configuration aware and do not support the features described in th
 [[profiles]]
 == Profiles
 
-We often need to configure differently our application depending on the target _environment_. For example, the local
+We often need to configure our application differently depending on the target _environment_. For example, the local
 development environment may be different from the production environment.
 
 Configuration Profiles allow for multiple configurations in the same file or separate files and select between them via

_versions/main/guides/doc-contribute-docs-howto.adoc

@@ -8,21 +8,23 @@ include::_attributes.adoc[]
 :categories: contributing
 :fn-diataxis: footnote:diataxis[Procida, D. Diátaxis documentation framework. https://diataxis.fr/]
 
-Contribute to the documentation by using the recommended steps, workflow, and style guidance to ensure the content successfully renders on the Quarkus website portal.
-
-== Prerequisites
+Contribute to the documentation by using the recommended diataxis content types, steps, workflow, and style guidance to ensure the content successfully renders on the Quarkus website portal.
 
 Quarkus docs use link:https://asciidoc.org/[AsciiDoc] markup.
 
-We suggest you have the following materials nearby:
+== Prerequisites
 
-- An editor or IDE that provides syntax highlighting and previews for AsciiDoc, either natively or with a plugin.
-- The https://docs.asciidoctor.org/asciidoc/latest/syntax-quick-reference/[AsciiDoc syntax reference]
-- The xref:{doc-guides}/doc-reference.adoc[Quarkus style and content guidelines] for the required syntax, preferred style, and other conventions.
+* You have an editor or IDE that provides syntax highlighting and previews for AsciiDoc, either natively or with a plugin.
+* You have reviewed the following Quarkus contributor resources:
+** The link:https://github.com/quarkusio/quarkus/blob/main/CONTRIBUTING.md#documentation[Documentation] section of the Quarkus "Contributing" guide.
+** The xref:{doc-guides}/doc-reference.adoc[Quarkus style and content guidelines] for the required syntax, preferred style, and other conventions.
+** The xref:{doc-guides}/doc-concept.adoc[Quarkus documentation content types].
+* You have the https://docs.asciidoctor.org/asciidoc/latest/syntax-quick-reference/[AsciiDoc syntax reference] nearby.
 
 == Locate the source files for Quarkus docs
 
 - AsciiDoc files are in the `src/main/asciidoc` directory within the `docs` module of the {quarkus-base-url}/tree/main/docs[Quarkus GitHub repository].
+- The Quarkus doc templates are located in the `src/main/asciidoc/_templates` directory within the `docs` module of the {quarkus-base-url}/tree/main/docs[Quarkus GitHub repository].
 - Configuration documentation is generated from JavaDoc comments in Java source files.
 - Java, YAML, and other source files can also be xref:doc-reference.adoc#reference-source-code[referenced] by AsciiDoc files.
 - The link:https://quarkus.io/guides/[Quarkus documentation] menu page, also known as the doc index page, is sourced in the link:https://github.com/quarkusio/quarkusio.github.io[quarkusio.github.io] repository.
@@ -209,7 +211,7 @@ xref:<other-file-name>.adoc#title-heading[Title heading]
 
 Breaking this example apart, we are using the `xref` macro to refer to another file (`xref:<name-of-the-file>.adoc[Human-readable label]`) and inserting the anchor ID for the target section (`#title-heading`) just after the file name.
 
-See the xref:doc-reference.adoc#cross-references[Cross-references] section for path attributes that should be used in cross-document references.
+For more guidelines on writing cross-references, including the recommended path attributes, see xref:doc-reference.adoc#cross-references[Cross-references].
 
 == Preview and build Quarkus documentation