Merge branch 'quarkusio:main' into userstories-link

Author: insectengine

_data/wg.yaml

@@ -1,32 +1,16 @@
 ---
 working-groups:
-    - title: "Test classloading"
-      board-url: "https://github.com/orgs/quarkusio/projects/30"
-      short-description: The goal of this working group is to rewrite Quarkus's test classloading, so that tests are run in the same classloader as the application under tests, and Quarkus extensions can do "Quarkus-y" manipulations of test classes.
+    - title: "Quarkus 3.20 LTS"
+      board-url: "https://github.com/orgs/quarkusio/projects/41"
+      short-description: This working group aims to track the effort around the Quarkus 3.20 LTS version.
       readme: |
-        <p>At the moment, Quarkus tests are invoked using one classloader, and then executed in a different classloader. This mostly works well, but means some use cases don't work: extensions cannot manipulate test classes in the same way that they do normal application classes. For example, anything run via a JUnit @TestTemplate test case will see the un-transformed class.</p>
-        <p>It also means we have extra user-facing complexity, such as the QuarkusTest*Callbacks](https://quarkus.io/guides/getting-started-testing#enrichment-via-quarkustestcallback):</p>
-        <blockquote>
-        <p>While it is possible to use JUnit Jupiter callback interfaces like BeforeEachCallback, you might run into classloading issues because Quarkus has to run tests in a custom classloader which JUnit is not aware of.</p>
-        </blockquote>
-        <p>A final benefit is a reduction in the internal complexity of our code. Hopping between classloaders during test execution takes a lot of work, and adds a lot of code! It also is brittle in places. For example, because the hop between classloaders relies on serialization in some cases, it's becoming harder to do as the JVM tightens up security restrictions. We used to rely on xstream, but that stopped working in Java 17. In https://github.com/quarkusio/quarkus/pull/40601, @dmlloyd moved us to use the JBoss Serializer, which works better, but might still be affected by future restrictions on class access.</p>
-        <p>The goal of this working group is to allow test classes to fully participate in the 'quarkification' of classes. The mechanism for this is probably just to load the test classes with the classloader we intend to run them with, so that JUnit sees the 'correct' version of the class.</p>
-        <ul>
-        <li>Point of contact: @holly-cummins (@<strong>Holly Cummins</strong>  on Zulip)</li>
-        <li>Proposal: https://github.com/quarkusio/quarkus/discussions/41867</li>
-        <li>Discussion: <a href="https://quarkusio.zulipchat.com/#narrow/channel/187038-dev/topic/WG.20.2330.20Test.20Classloading.20chatter/">Zulip topic</a></li>
-        </ul>
+        <p>All the tasks related to the 3.20 LTS, including issues with backport, release process, and so on.</p>
       status: on track
       completed: false
-      last-activity: 2025-02-03
-      last-update-date: 2025-01-17
+      last-activity: 2025-02-04
+      last-update-date: 2024-12-17
       last-update: |
-        Latest CI run: https://github.com/holly-cummins/quarkus/actions/runs/12827466328 (the Misc4 failure is an upstream failure). 
-        
-        Native tests are all running cleanly, and depending which platform you look at, there are between 7 and 15 failing projects on the JVM builds. So that's good progress recovering from the rebase and continuing to fix issues.
-      point-of-contact: "@holly-cummins (@<strong>Holly Cummins</strong>  on Zulip)"
-      proposal: https://github.com/quarkusio/quarkus/discussions/41867
-      discussion: https://quarkusio.zulipchat.com/#narrow/channel/187038-dev/topic/WG.20.2330.20Test.20Classloading.20chatter/
+        Starting tracking tasks fro the 3.19 LTS.
     - title: "Observability.Next"
       board-url: "https://github.com/orgs/quarkusio/projects/42"
       short-description: Observability.Next is a strategic initiative to modernize the observability stack within the Quarkus framework, aiming to streamline and enhance its ability to monitor and manage distributed systems.
@@ -94,23 +78,50 @@ working-groups:
         </ul>
       status: on track
       completed: false
-      last-activity: 2025-02-03
+      last-activity: 2025-02-04
       last-update-date: 2025-01-30
       last-update: |
         The initiative just started.
       point-of-contact: "@brunobat"
       proposal: https://github.com/quarkusio/quarkus/discussions/44423
-    - title: "Quarkus 3.20 LTS"
-      board-url: "https://github.com/orgs/quarkusio/projects/41"
-      short-description: This working group aims to track the effort around the Quarkus 3.20 LTS version.
+    - title: "Test classloading"
+      board-url: "https://github.com/orgs/quarkusio/projects/30"
+      short-description: The goal of this working group is to rewrite Quarkus's test classloading, so that tests are run in the same classloader as the application under tests, and Quarkus extensions can do "Quarkus-y" manipulations of test classes.
       readme: |
-        <p>All the tasks related to the 3.20 LTS, including issues with backport, release process, and so on.</p>
+        <p>At the moment, Quarkus tests are invoked using one classloader, and then executed in a different classloader. This mostly works well, but means some use cases don't work: extensions cannot manipulate test classes in the same way that they do normal application classes. For example, anything run via a JUnit @TestTemplate test case will see the un-transformed class.</p>
+        <p>It also means we have extra user-facing complexity, such as the QuarkusTest*Callbacks](https://quarkus.io/guides/getting-started-testing#enrichment-via-quarkustestcallback):</p>
+        <blockquote>
+        <p>While it is possible to use JUnit Jupiter callback interfaces like BeforeEachCallback, you might run into classloading issues because Quarkus has to run tests in a custom classloader which JUnit is not aware of.</p>
+        </blockquote>
+        <p>A final benefit is a reduction in the internal complexity of our code. Hopping between classloaders during test execution takes a lot of work, and adds a lot of code! It also is brittle in places. For example, because the hop between classloaders relies on serialization in some cases, it's becoming harder to do as the JVM tightens up security restrictions. We used to rely on xstream, but that stopped working in Java 17. In https://github.com/quarkusio/quarkus/pull/40601, @dmlloyd moved us to use the JBoss Serializer, which works better, but might still be affected by future restrictions on class access.</p>
+        <p>The goal of this working group is to allow test classes to fully participate in the 'quarkification' of classes. The mechanism for this is probably just to load the test classes with the classloader we intend to run them with, so that JUnit sees the 'correct' version of the class.</p>
+        <ul>
+        <li>Point of contact: @holly-cummins (@<strong>Holly Cummins</strong>  on Zulip)</li>
+        <li>Proposal: https://github.com/quarkusio/quarkus/discussions/41867</li>
+        <li>Discussion: <a href="https://quarkusio.zulipchat.com/#narrow/channel/187038-dev/topic/WG.20.2330.20Test.20Classloading.20chatter/">Zulip topic</a></li>
+        </ul>
       status: on track
       completed: false
       last-activity: 2025-02-03
-      last-update-date: 2024-12-17
+      last-update-date: 2025-02-04
       last-update: |
-        Starting tracking tasks fro the 3.19 LTS.
+        We have the first clean CI! It resolves the following issues:
+        
+        - https://github.com/quarkusio/quarkus/issues/45349
+        - https://github.com/quarkusio/quarkus/issues/8446
+        - https://github.com/quarkusio/quarkus/issues/42000
+        - https://github.com/quarkusio/quarkus/issues/42006
+        - https://github.com/quarkusio/quarkus/issues/44320
+        
+        There are ~360 TODOs in the code. The following problems are introduced by the changes:
+        
+        - Dev services start in the discovery phase (
+        https://github.com/quarkusio/quarkus/issues/45785 )
+        - Maven surefire.rerunFailingTestsCount option does not work in the case where there are test profiles or resources, unless the test order falls such that the failing test uses the last profile/resource (
+        https://github.com/quarkusio/quarkus/issues/46048)
+      point-of-contact: "@holly-cummins (@<strong>Holly Cummins</strong>  on Zulip)"
+      proposal: https://github.com/quarkusio/quarkus/discussions/41867
+      discussion: https://quarkusio.zulipchat.com/#narrow/channel/187038-dev/topic/WG.20.2330.20Test.20Classloading.20chatter/
     - title: "WebSocket Next"
       board-url: "https://github.com/orgs/quarkusio/projects/26"
       short-description: WebSocket-Next related tasks

_sass/includes/back-to-top.scss

@@ -16,6 +16,7 @@
 
   i {
     margin-top: .5rem;
+    padding: 0;
   }
 }
 #backToTop:hover {

_sass/includes/redhat-footer.scss

@@ -46,7 +46,7 @@
     @media screen and (max-width: 480px) {
       grid-column: 1/13;
       justify-self: center;
-      order: 2;
+      order: 1;
     }
   }
   .redhat-logo {
@@ -57,7 +57,7 @@
     @media screen and (max-width: 480px) {
       grid-column: 1/13;
       justify-self: center;
-      order: 1;
+      order: 2;
     }
   }
 }

_versions/main/guides/_attributes.adoc

@@ -19,7 +19,7 @@
 :logstash-image: docker.io/elastic/logstash:8.15.0
 :kibana-image: docker.io/elastic/kibana:8.15.0
 :keycloak-docker-image: quay.io/keycloak/keycloak:26.0.7
-:jandex-version: 3.2.3
+:jandex-version: 3.2.4
 :jandex-gradle-plugin-version: 1.0.0
 :kotlin-version: 2.0.21
 :grpc-version: 1.69.1

_versions/main/guides/hibernate-orm.adoc

@@ -1082,7 +1082,7 @@ Jump over to xref:datasource.adoc[Quarkus - Datasources] for all details.
 
 Quarkus currently supports the link:{hibernate-orm-docs-url}#multitenacy-separate-database[separate database] approach, the link:{hibernate-orm-docs-url}#multitenacy-separate-schema[separate schema] approach and the link:{hibernate-orm-docs-url}#multitenacy-discriminator[discriminator] approach.
 
-To see multitenancy in action, you can check out the link:{quickstarts-tree-url}/hibernate-orm-multi-tenancy-quickstart[hibernate-orm-multi-tenancy-quickstart] quickstart.
+To see multitenancy in action, you can check out the link:{quickstarts-tree-url}/hibernate-orm-multi-tenancy-schema-quickstart[hibernate-orm-multi-tenancy-schema-quickstart] or link:{quickstarts-tree-url}/hibernate-orm-multi-tenancy-database-quickstart[hibernate-orm-multi-tenancy-database-quickstart].
 
 === Writing the application
 
@@ -1210,7 +1210,7 @@ quarkus.hibernate-orm.multitenant=SCHEMA <2>
 quarkus.datasource.db-kind=postgresql <3>
 quarkus.datasource.username=quarkus_test
 quarkus.datasource.password=quarkus_test
-quarkus.datasource.jdbc.url=jdbc:postgresql://localhost:5432/quarkus_test
+%prod.quarkus.datasource.jdbc.url=jdbc:postgresql://localhost:5432/quarkus_test
 
 quarkus.flyway.schemas=base,mycompany <4>
 quarkus.flyway.locations=classpath:schema
@@ -1278,15 +1278,15 @@ quarkus.hibernate-orm.datasource=base <3>
 quarkus.datasource.base.db-kind=postgresql <4>
 quarkus.datasource.base.username=quarkus_test
 quarkus.datasource.base.password=quarkus_test
-quarkus.datasource.base.jdbc.url=jdbc:postgresql://localhost:5432/quarkus_test
+%prod.quarkus.datasource.base.jdbc.url=jdbc:postgresql://localhost:5432/quarkus_test
 quarkus.flyway.base.locations=classpath:database/base <5>
 quarkus.flyway.base.migrate-at-start=true
 
 # Tenant 'mycompany'
 quarkus.datasource.mycompany.db-kind=postgresql <6>
 quarkus.datasource.mycompany.username=mycompany
 quarkus.datasource.mycompany.password=mycompany
-quarkus.datasource.mycompany.jdbc.url=jdbc:postgresql://localhost:5433/mycompany
+%prod.quarkus.datasource.mycompany.jdbc.url=jdbc:postgresql://localhost:5433/mycompany
 quarkus.flyway.mycompany.locations=classpath:database/mycompany <7>
 quarkus.flyway.mycompany.migrate-at-start=true
 ----