Sync documentation of main branch

Author: actions-user

_versions/main/guides/getting-started-testing.adoc

@@ -1431,7 +1431,7 @@ An example use of this could be the following Maven command, that forces `@Quark
 ./mvnw verify -Dquarkus.http.test-host=1.2.3.4 -Dquarkus.http.test-port=4321
 ----
 
-To test against a running instance that only accepts SSL/TLS connection (example: `https://1.2.3.4:4321`) set the system property `quarkus.http.test-ssl-enabled` to `true`.
+To test against a running instance that only accepts SSL/TLS connection (example: `https://1.2.3.4:4321`) set the system property `quarkus.http.test-ssl-enabled` to `true` and `quarkus.http.test-ssl-port` to the target HTTPS port.
 
 == Mixing `@QuarkusTest` with other type of tests
 

_versions/main/guides/qute-reference.adoc

@@ -399,28 +399,32 @@ NOTE: The current context can be accessed via the implicit binding `this`.
 |===
 |Name |Description	|Examples
 
-|Elvis Operator
+|Elvis Operator: `?:`
 |Outputs the default value if the previous part cannot be resolved or resolves to `null`.
 |`{person.name ?: 'John'}`, `{person.name or 'John'}`, `{person.name.or('John')}`
 
-|orEmpty
+|`orEmpty`
 |Outputs an empty list if the previous part cannot be resolved or resolves to `null`.
 |`{pets.orEmpty.size}` outputs `0` if `pets` is not resolvable or `null`
 
-|Ternary Operator
+|Ternary Operator: `condition ? ifTrue : ifFalse`
 |Shorthand for if-then-else statement. Unlike in <<if_section>> nested operators are not supported.
 |`{item.isActive ? item.name : 'Inactive item'}` outputs the value of `item.name` if `item.isActive` resolves to `true`.
 
-|Logical AND Operator
+|Logical AND Operator: `&&`
 |Outputs `true` if both parts are not `falsy` as described in the <<if_section>>.
 The parameter is only evaluated if needed.
 |`{person.isActive && person.hasStyle}`
 
-|Logical OR Operator
+|Logical OR Operator: `\|\|`
 |Outputs `true` if any of the parts is not `falsy` as described in the <<if_section>>.
 The parameter is only evaluated if needed.
 |`{person.isActive \|\| person.hasStyle}`
 
+|Equals Operator: `==`/`eq`/`is`
+|Outputs `true` if the base object is equal to the argument.
+|`{obj1 is obj2 ? 'Equal' : 'Inequal'}`, `{obj1 == obj2 ? 'Equal' : 'Inequal'}`, `{obj1.eq(obj2) ? 'Equal' : 'Inequal'}`
+
 |===
 
 TIP: The condition in a ternary operator evaluates to `true` if the value is not considered `falsy` as described in <<if_section>>.
@@ -2263,22 +2267,23 @@ NOTE: Superfluous matching conditions are ignored. The conditions sorted by prio
 
 An extension method may declare parameters.
 If no namespace is specified then the first parameter that is not annotated with `@TemplateAttribute` is used to pass the base object, i.e. `org.acme.Item` in the first example.
-If matching any name or using a regular expression, then a string method parameter needs to be used to pass the property name.
+If matching any name or using a regular expression, then a string method parameter (not not annotated with `@TemplateAttribute`) needs to be used to pass the property name.
 Parameters annotated with `@TemplateAttribute` are obtained via `TemplateInstance#getAttribute()`.
-All other parameters are resolved when rendering the template and passed to the extension method.
+All other parameters are treated as virtual method parameters and resolved when rendering the template and passed to the extension method.
 
 .Multiple Parameters Example
 [source,java]
 ----
 @TemplateExtension
 class BigDecimalExtensions {
 
-    static BigDecimal scale(BigDecimal val, int scale, RoundingMode mode) { <1>
+    @TemplateExtension(matchNames = {"scale", "setScale"})
+    static BigDecimal scale(BigDecimal val, String ignoredName, int scale, RoundingMode mode) { <1>
         return val.setScale(scale, mode);
     }
 }
 ----
-<1> This method matches an expression with base object of the type `BigDecimal.class`, with the `scale` virtual method name and two virtual method parameters.
+<1> This method matches an expression with base object of the type `BigDecimal.class`, with the `scale()`/`setScale()` virtual method name and two virtual method parameters - `scale` and `mode`.
 
 [source,html]
 ----

_versions/main/guides/rest.adoc

@@ -2881,17 +2881,19 @@ However, you can change this default behavior and constrain a provider to:
 === Parameter mapping
 
 All <<request-parameters,Request Parameters>> can be declared as link:{jdkapi}/java/lang/String.html[`String`],
-but also any of the following types:
+but also as any of the following types:
 
-- Types for which a link:{jaxrsapi}/jakarta/ws/rs/ext/ParamConverter.html[`ParamConverter`] is available via a registered
+1. Types for which a link:{jaxrsapi}/jakarta/ws/rs/ext/ParamConverter.html[`ParamConverter`] is available via a registered
 link:{jaxrsapi}/jakarta/ws/rs/ext/ParamConverterProvider.html[`ParamConverterProvider`].
-- Primitive types.
-- Types that have a constructor that accepts a single link:{jdkapi}/java/lang/String.html[`String`] argument.
-- Types that have a static method named `valueOf` or `fromString` with a single link:{jdkapi}/java/lang/String.html[`String`] argument
+2. Primitive types.
+3. Types that have a constructor that accepts a single link:{jdkapi}/java/lang/String.html[`String`] argument.
+4. Types that have a static method named `valueOf` or `fromString` with a single link:{jdkapi}/java/lang/String.html[`String`] argument
 that return an instance of the type. If both methods are present then `valueOf` will be used unless
 the type is an `enum` in which case `fromString` will be used.
-- link:{jdkapi}/java/util/List.html[`List<T>`], link:{jdkapi}/java/util/Set.html[`Set<T>`], or
-link:{jdkapi}/java/util/SortedSet.html[`SortedSet<T>`], where `T` satisfies any above criterion.
+5. link:{jdkapi}/java/util/List.html[`List<T>`], link:{jdkapi}/java/util/Set.html[`Set<T>`], or
+link:{jdkapi}/java/util/SortedSet.html[`SortedSet<T>`], where `T` satisfies 1, 3 or 4 above.
+
+For 3 and 4, constructor instantiation is prioritesed above method instantiation. Public, protected, and package private constructors and methods are supported for instantiation.
 
 The following example illustrates all those possibilities:
 

_versions/main/guides/tls-registry-reference.adoc

@@ -849,7 +849,8 @@ quarkus.tls.http.key-store.pem.0.key=tls.key
 [IMPORTANT]
 ====
 Impacted servers and clients may need to listen to the `CertificateUpdatedEvent` to apply the new certificates.
-This is automatically done for the Quarkus HTTP server, such as the Quarkus REST server, gRPC server, and WebSocket server, as well as the management interface if it is enabled.
+This is automatically done for the Quarkus HTTP server, as well as the Quarkus REST server, gRPC server, and WebSocket server, as well as the management interface if it is enabled.
+On the client side, Quarkus REST Client automatically handles certificate update events.
 ====
 
 NOTE: In Quarkus dev mode, when files are touched, it will trigger the `CertificateUpdatedEvent` much more frequently.